@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSServiceCatalogClient extends AmazonWebServiceClient implements AWSServiceCatalog
Overview
AWS Service Catalog allows organizations to create and manage catalogs of IT services that are approved for use on AWS. This documentation provides reference material for the AWS Service Catalog end user API. To get the most out of this documentation, you need to be familiar with the terminology discussed in AWS Service Catalog Concepts.
Additional Resources
| Modifier and Type | Field and Description |
|---|---|
protected static ClientConfigurationFactory |
configFactory
Client configuration factory providing ClientConfigurations tailored to this client
|
client, clientConfiguration, endpoint, LOGGING_AWS_REQUEST_METRIC, requestHandler2s, timeOffsetENDPOINT_PREFIX| Constructor and Description |
|---|
AWSServiceCatalogClient()
Deprecated.
|
AWSServiceCatalogClient(AWSCredentials awsCredentials)
Deprecated.
use
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example:
AWSServiceCatalogClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build(); |
AWSServiceCatalogClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
|
AWSServiceCatalogClient(AWSCredentialsProvider awsCredentialsProvider)
Deprecated.
|
AWSServiceCatalogClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
|
AWSServiceCatalogClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
|
AWSServiceCatalogClient(ClientConfiguration clientConfiguration)
Deprecated.
|
addRequestHandler, addRequestHandler, beforeClientExecution, beforeMarshalling, calculateCRC32FromCompressedData, checkMutability, configureRegion, createExecutionContext, createExecutionContext, createExecutionContext, createSignerProvider, endClientExecution, endClientExecution, getEndpointPrefix, getRequestMetricsCollector, getServiceAbbreviation, getServiceName, getServiceNameIntern, getSigner, getSignerByURI, getSignerOverride, getSignerProvider, getSignerRegionOverride, getTimeOffset, isProfilingEnabled, isRequestMetricsEnabled, makeImmutable, removeRequestHandler, removeRequestHandler, requestMetricCollector, setEndpoint, setEndpointPrefix, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, useStrictHostNameVerification, withEndpoint, withRegion, withRegion, withTimeOffsetclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitsetEndpoint, setRegion, shutdownprotected static final ClientConfigurationFactory configFactory
@Deprecated public AWSServiceCatalogClient()
AWSServiceCatalogClientBuilder.defaultClient()All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain@Deprecated public AWSServiceCatalogClient(ClientConfiguration clientConfiguration)
AwsClientBuilder.withClientConfiguration(ClientConfiguration)All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration - The client configuration options controlling how this client connects to AWS Service Catalog (ex: proxy
settings, retry counts, etc.).DefaultAWSCredentialsProviderChain@Deprecated public AWSServiceCatalogClient(AWSCredentials awsCredentials)
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example:
AWSServiceCatalogClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.@Deprecated public AWSServiceCatalogClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider) and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.clientConfiguration - The client configuration options controlling how this client connects to AWS Service Catalog (ex: proxy
settings, retry counts, etc.).@Deprecated public AWSServiceCatalogClient(AWSCredentialsProvider awsCredentialsProvider)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.@Deprecated public AWSServiceCatalogClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider) and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration - The client configuration options controlling how this client connects to AWS Service Catalog (ex: proxy
settings, retry counts, etc.).@Deprecated public AWSServiceCatalogClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
AwsClientBuilder.withCredentials(AWSCredentialsProvider) and
AwsClientBuilder.withClientConfiguration(ClientConfiguration) and
AwsClientBuilder.withMetricsCollector(RequestMetricCollector)All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration - The client configuration options controlling how this client connects to AWS Service Catalog (ex: proxy
settings, retry counts, etc.).requestMetricCollector - optional request metric collectorpublic static AWSServiceCatalogClientBuilder builder()
public AcceptPortfolioShareResult acceptPortfolioShare(AcceptPortfolioShareRequest request)
Accepts an offer to share a portfolio.
acceptPortfolioShare in interface AWSServiceCatalogacceptPortfolioShareRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.public AssociatePrincipalWithPortfolioResult associatePrincipalWithPortfolio(AssociatePrincipalWithPortfolioRequest request)
Associates the specified principal ARN with the specified portfolio.
associatePrincipalWithPortfolio in interface AWSServiceCatalogassociatePrincipalWithPortfolioRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.public AssociateProductWithPortfolioResult associateProductWithPortfolio(AssociateProductWithPortfolioRequest request)
Associates a product with a portfolio.
associateProductWithPortfolio in interface AWSServiceCatalogassociateProductWithPortfolioRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.public CreateConstraintResult createConstraint(CreateConstraintRequest request)
Creates a new constraint.
createConstraint in interface AWSServiceCatalogcreateConstraintRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.DuplicateResourceException - The specified resource is a duplicate.public CreatePortfolioResult createPortfolio(CreatePortfolioRequest request)
Creates a new portfolio.
createPortfolio in interface AWSServiceCatalogcreatePortfolioRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.public CreatePortfolioShareResult createPortfolioShare(CreatePortfolioShareRequest request)
Creates a new portfolio share.
createPortfolioShare in interface AWSServiceCatalogcreatePortfolioShareRequest - ResourceNotFoundException - The specified resource was not found.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.InvalidParametersException - One or more parameters provided to the operation are invalid.public CreateProductResult createProduct(CreateProductRequest request)
Creates a new product.
createProduct in interface AWSServiceCatalogcreateProductRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.public CreateProvisioningArtifactResult createProvisioningArtifact(CreateProvisioningArtifactRequest request)
Create a new provisioning artifact for the specified product. This operation will not work with a product that has been shared with you.
createProvisioningArtifact in interface AWSServiceCatalogcreateProvisioningArtifactRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.public DeleteConstraintResult deleteConstraint(DeleteConstraintRequest request)
Deletes the specified constraint.
deleteConstraint in interface AWSServiceCatalogdeleteConstraintRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public DeletePortfolioResult deletePortfolio(DeletePortfolioRequest request)
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.
deletePortfolio in interface AWSServiceCatalogdeletePortfolioRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceInUseException - The operation was requested against a resource that is currently in use. Free the resource from use and
retry the operation.public DeletePortfolioShareResult deletePortfolioShare(DeletePortfolioShareRequest request)
Deletes the specified portfolio share.
deletePortfolioShare in interface AWSServiceCatalogdeletePortfolioShareRequest - ResourceNotFoundException - The specified resource was not found.public DeleteProductResult deleteProduct(DeleteProductRequest request)
Deletes the specified product. This operation will not work with a product that has been shared with you or is associated with a portfolio.
deleteProduct in interface AWSServiceCatalogdeleteProductRequest - ResourceNotFoundException - The specified resource was not found.ResourceInUseException - The operation was requested against a resource that is currently in use. Free the resource from use and
retry the operation.InvalidParametersException - One or more parameters provided to the operation are invalid.public DeleteProvisioningArtifactResult deleteProvisioningArtifact(DeleteProvisioningArtifactRequest request)
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).
deleteProvisioningArtifact in interface AWSServiceCatalogdeleteProvisioningArtifactRequest - ResourceNotFoundException - The specified resource was not found.ResourceInUseException - The operation was requested against a resource that is currently in use. Free the resource from use and
retry the operation.InvalidParametersException - One or more parameters provided to the operation are invalid.public DescribeConstraintResult describeConstraint(DescribeConstraintRequest request)
Retrieves detailed information for a specified constraint.
describeConstraint in interface AWSServiceCatalogdescribeConstraintRequest - ResourceNotFoundException - The specified resource was not found.public DescribePortfolioResult describePortfolio(DescribePortfolioRequest request)
Retrieves detailed information and any tags associated with the specified portfolio.
describePortfolio in interface AWSServiceCatalogdescribePortfolioRequest - ResourceNotFoundException - The specified resource was not found.public DescribeProductResult describeProduct(DescribeProductRequest request)
Retrieves information about a specified product.
This operation is functionally identical to DescribeProductView except that it takes as input
ProductId instead of ProductViewId.
describeProduct in interface AWSServiceCatalogdescribeProductRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public DescribeProductAsAdminResult describeProductAsAdmin(DescribeProductAsAdminRequest request)
Retrieves information about a specified product, run with administrator access.
describeProductAsAdmin in interface AWSServiceCatalogdescribeProductAsAdminRequest - ResourceNotFoundException - The specified resource was not found.public DescribeProductViewResult describeProductView(DescribeProductViewRequest request)
Retrieves information about a specified product.
This operation is functionally identical to DescribeProduct except that it takes as input
ProductViewId instead of ProductId.
describeProductView in interface AWSServiceCatalogdescribeProductViewRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public DescribeProvisioningArtifactResult describeProvisioningArtifact(DescribeProvisioningArtifactRequest request)
Retrieves detailed information about the specified provisioning artifact.
describeProvisioningArtifact in interface AWSServiceCatalogdescribeProvisioningArtifactRequest - ResourceNotFoundException - The specified resource was not found.public DescribeProvisioningParametersResult describeProvisioningParameters(DescribeProvisioningParametersRequest request)
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.
describeProvisioningParameters in interface AWSServiceCatalogdescribeProvisioningParametersRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.public DescribeRecordResult describeRecord(DescribeRecordRequest request)
Retrieves a paginated list of the full details of a specific request. Use this operation after calling a request operation (ProvisionProduct, TerminateProvisionedProduct, or UpdateProvisionedProduct).
describeRecord in interface AWSServiceCatalogdescribeRecordRequest - ResourceNotFoundException - The specified resource was not found.public DisassociatePrincipalFromPortfolioResult disassociatePrincipalFromPortfolio(DisassociatePrincipalFromPortfolioRequest request)
Disassociates a previously associated principal ARN from a specified portfolio.
disassociatePrincipalFromPortfolio in interface AWSServiceCatalogdisassociatePrincipalFromPortfolioRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.public DisassociateProductFromPortfolioResult disassociateProductFromPortfolio(DisassociateProductFromPortfolioRequest request)
Disassociates the specified product from the specified portfolio.
disassociateProductFromPortfolio in interface AWSServiceCatalogdisassociateProductFromPortfolioRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public ListAcceptedPortfolioSharesResult listAcceptedPortfolioShares(ListAcceptedPortfolioSharesRequest request)
Lists details of all portfolios for which sharing was accepted by this account.
listAcceptedPortfolioShares in interface AWSServiceCataloglistAcceptedPortfolioSharesRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.public ListConstraintsForPortfolioResult listConstraintsForPortfolio(ListConstraintsForPortfolioRequest request)
Retrieves detailed constraint information for the specified portfolio and product.
listConstraintsForPortfolio in interface AWSServiceCataloglistConstraintsForPortfolioRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public ListLaunchPathsResult listLaunchPaths(ListLaunchPathsRequest request)
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.
listLaunchPaths in interface AWSServiceCataloglistLaunchPathsRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.public ListPortfolioAccessResult listPortfolioAccess(ListPortfolioAccessRequest request)
Lists the account IDs that have been authorized sharing of the specified portfolio.
listPortfolioAccess in interface AWSServiceCataloglistPortfolioAccessRequest - ResourceNotFoundException - The specified resource was not found.public ListPortfoliosResult listPortfolios(ListPortfoliosRequest request)
Lists all portfolios in the catalog.
listPortfolios in interface AWSServiceCataloglistPortfoliosRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.public ListPortfoliosForProductResult listPortfoliosForProduct(ListPortfoliosForProductRequest request)
Lists all portfolios that the specified product is associated with.
listPortfoliosForProduct in interface AWSServiceCataloglistPortfoliosForProductRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.public ListPrincipalsForPortfolioResult listPrincipalsForPortfolio(ListPrincipalsForPortfolioRequest request)
Lists all principal ARNs associated with the specified portfolio.
listPrincipalsForPortfolio in interface AWSServiceCataloglistPrincipalsForPortfolioRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public ListProvisioningArtifactsResult listProvisioningArtifacts(ListProvisioningArtifactsRequest request)
Lists all provisioning artifacts associated with the specified product.
listProvisioningArtifacts in interface AWSServiceCataloglistProvisioningArtifactsRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public ListRecordHistoryResult listRecordHistory(ListRecordHistoryRequest request)
Returns a paginated list of all performed requests, in the form of RecordDetails objects that are filtered as specified.
listRecordHistory in interface AWSServiceCataloglistRecordHistoryRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.public ProvisionProductResult provisionProduct(ProvisionProductRequest request)
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.
provisionProduct in interface AWSServiceCatalogprovisionProductRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.DuplicateResourceException - The specified resource is a duplicate.public RejectPortfolioShareResult rejectPortfolioShare(RejectPortfolioShareRequest request)
Rejects an offer to share a portfolio.
rejectPortfolioShare in interface AWSServiceCatalogrejectPortfolioShareRequest - ResourceNotFoundException - The specified resource was not found.public ScanProvisionedProductsResult scanProvisionedProducts(ScanProvisionedProductsRequest request)
Returns a paginated list of all the ProvisionedProduct objects that are currently available (not terminated).
scanProvisionedProducts in interface AWSServiceCatalogscanProvisionedProductsRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.public SearchProductsResult searchProducts(SearchProductsRequest request)
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.
searchProducts in interface AWSServiceCatalogsearchProductsRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.public SearchProductsAsAdminResult searchProductsAsAdmin(SearchProductsAsAdminRequest request)
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.
searchProductsAsAdmin in interface AWSServiceCatalogsearchProductsAsAdminRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public TerminateProvisionedProductResult terminateProvisionedProduct(TerminateProvisionedProductRequest request)
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.
terminateProvisionedProduct in interface AWSServiceCatalogterminateProvisionedProductRequest - ResourceNotFoundException - The specified resource was not found.public UpdateConstraintResult updateConstraint(UpdateConstraintRequest request)
Updates an existing constraint.
updateConstraint in interface AWSServiceCatalogupdateConstraintRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public UpdatePortfolioResult updatePortfolio(UpdatePortfolioRequest request)
Updates the specified portfolio's details. This operation will not work with a product that has been shared with you.
updatePortfolio in interface AWSServiceCatalogupdatePortfolioRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.LimitExceededException - The current limits of the service would have been exceeded by this operation. Reduce the resource use or
increase the service limits and retry the operation.public UpdateProductResult updateProduct(UpdateProductRequest request)
Updates an existing product.
updateProduct in interface AWSServiceCatalogupdateProductRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public UpdateProvisionedProductResult updateProvisionedProduct(UpdateProvisionedProductRequest request)
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.
updateProvisionedProduct in interface AWSServiceCatalogupdateProvisionedProductRequest - InvalidParametersException - One or more parameters provided to the operation are invalid.ResourceNotFoundException - The specified resource was not found.public UpdateProvisioningArtifactResult updateProvisioningArtifact(UpdateProvisioningArtifactRequest request)
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.
updateProvisioningArtifact in interface AWSServiceCatalogupdateProvisioningArtifactRequest - ResourceNotFoundException - The specified resource was not found.InvalidParametersException - One or more parameters provided to the operation are invalid.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata in interface AWSServiceCatalogrequest - The originally executed requestCopyright © 2017. All rights reserved.