software.amazon.awscdk.services.servicecatalog

Class Portfolio

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.servicecatalog.Portfolio

All Implemented Interfaces:

IDependable, IResource, IPortfolio, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct

@Generated(value="jsii-pacmak/1.47.0 (build 86d2c33)",
           date="2021-12-15T10:03:45.291Z")
 @Stability(value=Experimental)
public class Portfolio
extends Resource
implements IPortfolio

(experimental) A Service Catalog portfolio.

Example:

 Portfolio.Builder.create(this, "MyFirstPortfolio")
         .displayName("MyFirstPortfolio")
         .providerName("MyTeam")
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Portfolio.Builder (experimental) A fluent builder for Portfolio.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.servicecatalog.IPortfolio

IPortfolio.Jsii$Default, IPortfolio.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
	Portfolio(software.constructs.Construct scope, String id, PortfolioProps props)
protected	Portfolio(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Portfolio(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
void	addProduct(IProduct product) (experimental) Associate portfolio with the given product.
void	associateTagOptions(TagOptions tagOptions) (experimental) Associate Tag Options.
void	constrainCloudFormationParameters(IProduct product, CloudFormationRuleConstraintOptions options) (experimental) Set provisioning rules for the product.
void	constrainTagUpdates(IProduct product) (experimental) Add a Resource Update Constraint.
void	constrainTagUpdates(IProduct product, TagUpdateConstraintOptions options) (experimental) Add a Resource Update Constraint.
void	deployWithStackSets(IProduct product, StackSetsConstraintOptions options) (experimental) Configure deployment options using AWS Cloudformation StackSets.
static IPortfolio	fromPortfolioArn(software.constructs.Construct scope, String id, String portfolioArn) (experimental) Creates a Portfolio construct that represents an external portfolio.
protected String	generateUniqueHash(String value) (experimental) Create a unique id based off the L1 CfnPortfolio or the arn of an imported portfolio.
String	getPortfolioArn() (experimental) The ARN of the portfolio.
String	getPortfolioId() (experimental) The ID of the portfolio.
void	giveAccessToGroup(IGroup group) (experimental) Associate portfolio with an IAM Group.
void	giveAccessToRole(IRole role) (experimental) Associate portfolio with an IAM Role.
void	giveAccessToUser(IUser user) (experimental) Associate portfolio with an IAM User.
void	notifyOnStackEvents(IProduct product, ITopic topic) (experimental) Add notifications for supplied topics on the provisioned product.
void	notifyOnStackEvents(IProduct product, ITopic topic, CommonConstraintOptions options) (experimental) Add notifications for supplied topics on the provisioned product.
void	setLaunchRole(IProduct product, IRole launchRole) (experimental) Force users to assume a certain role when launching a product.
void	setLaunchRole(IProduct product, IRole launchRole, CommonConstraintOptions options) (experimental) Force users to assume a certain role when launching a product.
void	setLocalLaunchRole(IProduct product, IRole launchRole) (experimental) Force users to assume a certain role when launching a product.
void	setLocalLaunchRole(IProduct product, IRole launchRole, CommonConstraintOptions options) (experimental) Force users to assume a certain role when launching a product.
IRole	setLocalLaunchRoleName(IProduct product, String launchRoleName) (experimental) Force users to assume a certain role when launching a product.
IRole	setLocalLaunchRoleName(IProduct product, String launchRoleName, CommonConstraintOptions options) (experimental) Force users to assume a certain role when launching a product.
void	shareWithAccount(String accountId) (experimental) Initiate a portfolio share with another account.
void	shareWithAccount(String accountId, PortfolioShareOptions options) (experimental) Initiate a portfolio share with another account.

Methods inherited from class software.amazon.awscdk.core.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class software.constructs.Construct

toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Portfolio

protected Portfolio(software.amazon.jsii.JsiiObjectRef objRef)

Portfolio

protected Portfolio(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Portfolio

@Stability(value=Experimental)
public Portfolio(@NotNull
                                                software.constructs.Construct scope,
                                                @NotNull
                                                String id,
                                                @NotNull
                                                PortfolioProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromPortfolioArn

@Stability(value=Experimental)
 @NotNull
public static IPortfolio fromPortfolioArn(@NotNull
                                                                                   software.constructs.Construct scope,
                                                                                   @NotNull
                                                                                   String id,
                                                                                   @NotNull
                                                                                   String portfolioArn)

(experimental) Creates a Portfolio construct that represents an external portfolio.

Parameters:

scope - The parent creating construct (usually `this`). This parameter is required.

id - The construct's name. This parameter is required.

portfolioArn - the Amazon Resource Name of the existing portfolio. This parameter is required.

addProduct

@Stability(value=Experimental)
public void addProduct(@NotNull
                                                      IProduct product)

(experimental) Associate portfolio with the given product.

Specified by:

addProduct in interface IPortfolio

Parameters:

product - This parameter is required.

associateTagOptions

@Stability(value=Experimental)
public void associateTagOptions(@NotNull
                                                               TagOptions tagOptions)

(experimental) Associate Tag Options.

A TagOption is a key-value pair managed in AWS Service Catalog. It is not an AWS tag, but serves as a template for creating an AWS tag based on the TagOption.

Specified by:

associateTagOptions in interface IPortfolio

Parameters:

tagOptions - This parameter is required.

constrainCloudFormationParameters

@Stability(value=Experimental)
public void constrainCloudFormationParameters(@NotNull
                                                                             IProduct product,
                                                                             @NotNull
                                                                             CloudFormationRuleConstraintOptions options)

(experimental) Set provisioning rules for the product.

Specified by:

constrainCloudFormationParameters in interface IPortfolio

Parameters:

product - This parameter is required.

options - This parameter is required.

constrainTagUpdates

@Stability(value=Experimental)
public void constrainTagUpdates(@NotNull
                                                               IProduct product,
                                                               @Nullable
                                                               TagUpdateConstraintOptions options)

(experimental) Add a Resource Update Constraint.

Specified by:

constrainTagUpdates in interface IPortfolio

Parameters:

product - This parameter is required.

options -

constrainTagUpdates

@Stability(value=Experimental)
public void constrainTagUpdates(@NotNull
                                                               IProduct product)

(experimental) Add a Resource Update Constraint.

Specified by:

constrainTagUpdates in interface IPortfolio

Parameters:

product - This parameter is required.

deployWithStackSets

@Stability(value=Experimental)
public void deployWithStackSets(@NotNull
                                                               IProduct product,
                                                               @NotNull
                                                               StackSetsConstraintOptions options)

(experimental) Configure deployment options using AWS Cloudformation StackSets.

Specified by:

deployWithStackSets in interface IPortfolio

Parameters:

product - This parameter is required.

options - This parameter is required.

generateUniqueHash

@Stability(value=Experimental)
 @NotNull
protected String generateUniqueHash(@NotNull
                                                                             String value)

(experimental) Create a unique id based off the L1 CfnPortfolio or the arn of an imported portfolio.

Parameters:

value - This parameter is required.

giveAccessToGroup

@Stability(value=Experimental)
public void giveAccessToGroup(@NotNull
                                                             IGroup group)

(experimental) Associate portfolio with an IAM Group.

Specified by:

giveAccessToGroup in interface IPortfolio

Parameters:

group - This parameter is required.

giveAccessToRole

@Stability(value=Experimental)
public void giveAccessToRole(@NotNull
                                                            IRole role)

(experimental) Associate portfolio with an IAM Role.

Specified by:

giveAccessToRole in interface IPortfolio

Parameters:

role - This parameter is required.

giveAccessToUser

@Stability(value=Experimental)
public void giveAccessToUser(@NotNull
                                                            IUser user)

(experimental) Associate portfolio with an IAM User.

Specified by:

giveAccessToUser in interface IPortfolio

Parameters:

user - This parameter is required.

notifyOnStackEvents

@Stability(value=Experimental)
public void notifyOnStackEvents(@NotNull
                                                               IProduct product,
                                                               @NotNull
                                                               ITopic topic,
                                                               @Nullable
                                                               CommonConstraintOptions options)

(experimental) Add notifications for supplied topics on the provisioned product.

Specified by:

notifyOnStackEvents in interface IPortfolio

Parameters:

product - This parameter is required.

topic - This parameter is required.

options -

notifyOnStackEvents

@Stability(value=Experimental)
public void notifyOnStackEvents(@NotNull
                                                               IProduct product,
                                                               @NotNull
                                                               ITopic topic)

(experimental) Add notifications for supplied topics on the provisioned product.

Specified by:

notifyOnStackEvents in interface IPortfolio

Parameters:

product - This parameter is required.

topic - This parameter is required.

setLaunchRole

@Stability(value=Experimental)
public void setLaunchRole(@NotNull
                                                         IProduct product,
                                                         @NotNull
                                                         IRole launchRole,
                                                         @Nullable
                                                         CommonConstraintOptions options)

(experimental) Force users to assume a certain role when launching a product.

This sets the launch role using the role arn which is tied to the account this role exists in. This is useful if you will be provisioning products from the account where this role exists. If you intend to share the portfolio across accounts, use a local launch role.

Specified by:

setLaunchRole in interface IPortfolio

Parameters:

product - This parameter is required.

launchRole - This parameter is required.

options -

setLaunchRole

@Stability(value=Experimental)
public void setLaunchRole(@NotNull
                                                         IProduct product,
                                                         @NotNull
                                                         IRole launchRole)

(experimental) Force users to assume a certain role when launching a product.

This sets the launch role using the role arn which is tied to the account this role exists in. This is useful if you will be provisioning products from the account where this role exists. If you intend to share the portfolio across accounts, use a local launch role.

Specified by:

setLaunchRole in interface IPortfolio

Parameters:

product - This parameter is required.

launchRole - This parameter is required.

setLocalLaunchRole

@Stability(value=Experimental)
public void setLocalLaunchRole(@NotNull
                                                              IProduct product,
                                                              @NotNull
                                                              IRole launchRole,
                                                              @Nullable
                                                              CommonConstraintOptions options)

(experimental) Force users to assume a certain role when launching a product.

The role name will be referenced by in the local account and must be set explicitly. This is useful when sharing the portfolio with multiple accounts.

Specified by:

setLocalLaunchRole in interface IPortfolio

Parameters:

product - This parameter is required.

launchRole - This parameter is required.

options -

setLocalLaunchRole

@Stability(value=Experimental)
public void setLocalLaunchRole(@NotNull
                                                              IProduct product,
                                                              @NotNull
                                                              IRole launchRole)

(experimental) Force users to assume a certain role when launching a product.

The role name will be referenced by in the local account and must be set explicitly. This is useful when sharing the portfolio with multiple accounts.

Specified by:

setLocalLaunchRole in interface IPortfolio

Parameters:

product - This parameter is required.

launchRole - This parameter is required.

setLocalLaunchRoleName

@Stability(value=Experimental)
 @NotNull
public IRole setLocalLaunchRoleName(@NotNull
                                                                             IProduct product,
                                                                             @NotNull
                                                                             String launchRoleName,
                                                                             @Nullable
                                                                             CommonConstraintOptions options)

(experimental) Force users to assume a certain role when launching a product.

The role will be referenced by name in the local account instead of a static role arn. A role with this name will automatically be created and assumable by Service Catalog in this account. This is useful when sharing the portfolio with multiple accounts.

Specified by:

setLocalLaunchRoleName in interface IPortfolio

Parameters:

product - This parameter is required.

launchRoleName - This parameter is required.

options -

setLocalLaunchRoleName

@Stability(value=Experimental)
 @NotNull
public IRole setLocalLaunchRoleName(@NotNull
                                                                             IProduct product,
                                                                             @NotNull
                                                                             String launchRoleName)

(experimental) Force users to assume a certain role when launching a product.

The role will be referenced by name in the local account instead of a static role arn. A role with this name will automatically be created and assumable by Service Catalog in this account. This is useful when sharing the portfolio with multiple accounts.

Specified by:

setLocalLaunchRoleName in interface IPortfolio

Parameters:

product - This parameter is required.

launchRoleName - This parameter is required.

shareWithAccount

@Stability(value=Experimental)
public void shareWithAccount(@NotNull
                                                            String accountId,
                                                            @Nullable
                                                            PortfolioShareOptions options)

(experimental) Initiate a portfolio share with another account.

Specified by:

shareWithAccount in interface IPortfolio

Parameters:

accountId - This parameter is required.

options -

shareWithAccount

@Stability(value=Experimental)
public void shareWithAccount(@NotNull
                                                            String accountId)

(experimental) Initiate a portfolio share with another account.

Specified by:

shareWithAccount in interface IPortfolio

Parameters:

accountId - This parameter is required.

getPortfolioArn

@Stability(value=Experimental)
 @NotNull
public String getPortfolioArn()

(experimental) The ARN of the portfolio.

Specified by:

getPortfolioArn in interface IPortfolio

getPortfolioId

@Stability(value=Experimental)
 @NotNull
public String getPortfolioId()

(experimental) The ID of the portfolio.

Specified by:

getPortfolioId in interface IPortfolio