Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Esempi di Service Catalog utilizzando AWS CLI
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Service Catalog.
Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
**Topics**
+ [Azioni](#actions)
## Azioni
### `accept-portfolio-share`
Il seguente esempio di codice mostra come utilizzare`accept-portfolio-share`.
**AWS CLI**
**Come accettare una condivisione di portafoglio**
L’esempio `accept-portfolio-share` seguente accetta un’offerta, effettuata da un altro utente, per condividere il portafoglio specificato.
```
aws servicecatalog accept-portfolio-share \
--portfolio-id port-2s6wuabcdefghijk
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [AcceptPortfolioShare AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/accept-portfolio-share.html)*Command Reference*.
### `associate-principal-with-portfolio`
Il seguente esempio di codice mostra come utilizzare`associate-principal-with-portfolio`.
**AWS CLI**
**Come associare un principale a un portafoglio**
L’esempio `associate-principal-with-portfolio` seguente associa un utente al portafoglio specificato.
```
aws servicecatalog associate-principal-with-portfolio \
--portfolio-id port-2s6abcdefwdh4 \
--principal-arn arn:aws:iam::123456789012:user/usertest \
--principal-type IAM
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [AssociatePrincipalWithPortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/associate-principal-with-portfolio.html)*Command Reference*.
### `associate-product-with-portfolio`
Il seguente esempio di codice mostra come utilizzare`associate-product-with-portfolio`.
**AWS CLI**
**Come associare un prodotto a un portafoglio**
L’esempio `associate-product-with-portfolio` seguente associa il prodotto indicato al portafoglio specificato.
```
aws servicecatalog associate-product-with-portfolio
--product-id prod-3p5abcdef3oyk
--portfolio-id port-2s6abcdef5wdh4
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [AssociateProductWithPortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/associate-product-with-portfolio.html)*Command Reference*.
### `associate-tag-option-with-resource`
Il seguente esempio di codice mostra come utilizzare`associate-tag-option-with-resource`.
**AWS CLI**
**Associare un a TagOption a una risorsa**
L'`associate-tag-option-with-resource`esempio seguente associa la risorsa specificata TagOption alla risorsa specificata.
```
aws servicecatalog associate-tag-option-with-resource \
--resource-id port-2s6abcdq5wdh4 \
--tag-option-id tag-p3abc2pkpz5qc
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, vedere [AssociateTagOptionWithResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/associate-tag-option-with-resource.html)in *AWS CLI Command Reference.*
### `copy-product`
Il seguente esempio di codice mostra come utilizzare`copy-product`.
**AWS CLI**
**Come copiare un prodotto**
L’esempio `copy-product` seguente crea una copia del prodotto specificato, utilizzando un file JSON per passare i parametri.
```
aws servicecatalog copy-product --cli-input-json file://copy-product-input.json
```
Contenuto di `copy-product-input.json`:
```
{
"SourceProductArn": "arn:aws:catalog:us-west-2:123456789012:product/prod-tcabcd3syn2xy",
"TargetProductName": "copy-of-myproduct",
"CopyOptions": [
"CopyTags"
]
}
```
Output:
```
{
"CopyProductToken": "copyproduct-abc5defgjkdji"
}
```
+ Per i dettagli sull'API, consulta [CopyProduct AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/copy-product.html)*Command Reference*.
### `create-portfolio-share`
Il seguente esempio di codice mostra come utilizzare`create-portfolio-share`.
**AWS CLI**
**Come condividere un portafoglio con un account**
L’esempio `create-portfolio-share` seguente condivide il portafoglio specificato con l’account specificato.
```
aws servicecatalog create-portfolio-share \
--portfolio-id port-2s6abcdef5wdh4 \
--account-id 794123456789
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [CreatePortfolioShare AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-portfolio-share.html)*Command Reference*.
### `create-portfolio`
Il seguente esempio di codice mostra come utilizzare`create-portfolio`.
**AWS CLI**
**Come creare un portafoglio**
L’esempio `create-portfolio` seguente crea un portafoglio.
```
aws servicecatalog create-portfolio \
--provider-name my-provider \
--display-name my-portfolio
```
Output:
```
{
"PortfolioDetail": {
"ProviderName": "my-provider",
"DisplayName": "my-portfolio",
"CreatedTime": 1571337221.555,
"ARN": "arn:aws:catalog:us-east-2:123456789012:portfolio/port-2s6xmplq5wdh4",
"Id": "port-2s6xmplq5wdh4"
}
}
```
+ Per i dettagli sull'API, consulta [CreatePortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-portfolio.html)*Command Reference*.
### `create-product`
Il seguente esempio di codice mostra come utilizzare`create-product`.
**AWS CLI**
**Come creare un prodotto**
L’esempio `create-product` seguente crea un prodotto, utilizzando un file JSON per passare i parametri.
```
aws servicecatalog create-product \
--cli-input-json file://create-product-input.json
```
Contenuto di `create-product-input.json`:
```
{
"AcceptLanguage": "en",
"Name": "test-product",
"Owner": "test-owner",
"Description": "test-description",
"Distributor": "test-distributor",
"SupportDescription": "test-support",
"SupportEmail": "test@amazon.com",
"SupportUrl": "https://aws.amazon.com",
"ProductType": "CLOUD_FORMATION_TEMPLATE",
"Tags": [
{
"Key": "region",
"Value": "us-east-1"
}
],
"ProvisioningArtifactParameters": {
"Name": "test-version-name",
"Description": "test-version-description",
"Info": {
"LoadTemplateFromURL": "https://s3-us-west-1.amazonaws.com/cloudformation-templates-us-west-1/my-cfn-template.template"
},
"Type": "CLOUD_FORMATION_TEMPLATE"
}
}
```
Output:
```
{
"Tags": [
{
"Key": "region",
"Value": "us-east-1"
}
],
"ProductViewDetail": {
"CreatedTime": 1576025036.0,
"ProductARN": "arn:aws:catalog:us-west-2:1234568542028:product/prod-3p5abcdef3oyk",
"Status": "CREATED",
"ProductViewSummary": {
"Type": "CLOUD_FORMATION_TEMPLATE",
"Distributor": "test-distributor",
"SupportUrl": "https://aws.amazon.com",
"SupportEmail": "test@amazon.com",
"Id": "prodview-abcd42wvx45um",
"SupportDescription": "test-support",
"ShortDescription": "test-description",
"Owner": "test-owner",
"Name": "test-product2",
"HasDefaultPath": false,
"ProductId": "prod-3p5abcdef3oyk"
}
},
"ProvisioningArtifactDetail": {
"CreatedTime": 1576025036.0,
"Active": true,
"Id": "pa-pq3p5lil12a34",
"Description": "test-version-description",
"Name": "test-version-name",
"Type": "CLOUD_FORMATION_TEMPLATE"
}
}
```
+ Per i dettagli sull'API, consulta [CreateProduct AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-product.html)*Command Reference*.
### `create-provisioning-artifact`
Il seguente esempio di codice mostra come utilizzare`create-provisioning-artifact`.
**AWS CLI**
**Come creare un artefatto di provisioning**
L’esempio `create-provisioning-artifact` seguente crea un artefatto di provisioning, utilizzando un file JSON per passare i parametri.
```
aws servicecatalog create-provisioning-artifact \
--cli-input-json file://create-provisioning-artifact-input.json
```
Contenuto di `create-provisioning-artifact-input.json`:
```
{
"ProductId": "prod-nfi2abcdefghi",
"Parameters": {
"Name": "test-provisioning-artifact",
"Description": "test description",
"Info": {
"LoadTemplateFromURL": "https://s3-us-west-1.amazonaws.com/cloudformation-templates-us-west-1/my-cfn-template.template"
},
"Type": "CLOUD_FORMATION_TEMPLATE"
}
}
```
Output:
```
{
"Info": {
"TemplateUrl": "https://s3-us-west-1.amazonaws.com/cloudformation-templates-us-west-1/my-cfn-template.template"
},
"Status": "CREATING",
"ProvisioningArtifactDetail": {
"Id": "pa-bb4abcdefwnaio",
"Name": "test-provisioning-artifact",
"Description": "test description",
"Active": true,
"Type": "CLOUD_FORMATION_TEMPLATE",
"CreatedTime": 1576022545.0
}
}
```
+ Per i dettagli sull'API, consulta [CreateProvisioningArtifact AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-provisioning-artifact.html)*Command Reference*.
### `create-tag-option`
Il seguente esempio di codice mostra come utilizzare`create-tag-option`.
**AWS CLI**
**Per creare un TagOption**
L'`create-tag-option`esempio seguente crea un TagOption.
```
aws servicecatalog create-tag-option
--key 1234
--value name
```
Output:
```
{
"TagOptionDetail": {
"Id": "tag-iabcdn4fzjjms",
"Value": "name",
"Active": true,
"Key": "1234"
}
}
```
+ Per i dettagli sull'API, vedere [CreateTagOption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-tag-option.html)in *AWS CLI Command Reference*.
### `delete-portfolio-share`
Il seguente esempio di codice mostra come utilizzare`delete-portfolio-share`.
**AWS CLI**
**Come arrestare la condivisione di un portafoglio con un account**
L’esempio `delete-portfolio-share` seguente interrompe la condivisione del portafoglio con l’account specificato.
```
aws servicecatalog delete-portfolio-share \
--portfolio-id port-2s6abcdq5wdh4 \
--account-id 123456789012
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DeletePortfolioShare AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-portfolio-share.html)*Command Reference*.
### `delete-portfolio`
Il seguente esempio di codice mostra come utilizzare`delete-portfolio`.
**AWS CLI**
**Come eliminare un portafoglio**
L’esempio `delete-portfolio` seguente elimina il portafoglio specificato.
```
aws servicecatalog delete-portfolio \
--id port-abcdlx4gox4do
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DeletePortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-portfolio.html)*Command Reference*.
### `delete-product`
Il seguente esempio di codice mostra come utilizzare`delete-product`.
**AWS CLI**
**Come eliminare un prodotto**
L’esempio `delete-product` seguente elimina il prodotto specificato.
```
aws servicecatalog delete-product \
--id prod-abcdcek6yhbxi
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DeleteProduct AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-product.html)*Command Reference*.
### `delete-provisioning-artifact`
Il seguente esempio di codice mostra come utilizzare`delete-provisioning-artifact`.
**AWS CLI**
**Come eliminare un artefatto di provisioning**
L’esempio `delete-provisioning-artifact` seguente elimina l’artefatto di provisioning specificato.
```
aws servicecatalog delete-provisioning-artifact \
--product-id prod-abc2uebuplcpw \
--provisioning-artifact-id pa-pqabcddii7ouc
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DeleteProvisioningArtifact AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-provisioning-artifact.html)*Command Reference*.
### `delete-tag-option`
Il seguente esempio di codice mostra come utilizzare`delete-tag-option`.
**AWS CLI**
**Per eliminare un TagOption**
L'`delete-tag-option`esempio seguente elimina il valore specificato TagOption.
```
aws servicecatalog delete-tag-option \
--id tag-iabcdn4fzjjms
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, vedere [DeleteTagOption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-tag-option.html)in *AWS CLI Command Reference.*
### `describe-copy-product-status`
Il seguente esempio di codice mostra come utilizzare`describe-copy-product-status`.
**AWS CLI**
**Come descrivere lo stato dell’operazione di copia del prodotto**
L’esempio `describe-copy-product-status` seguente mostra lo stato corrente dell’operazione di copia asincrona del prodotto specificata.
```
aws servicecatalog describe-copy-product-status \
--copy-product-token copyproduct-znn5tf5abcd3w
```
Output:
```
{
"CopyProductStatus": "SUCCEEDED",
"TargetProductId": "prod-os6hog7abcdt2"
}
```
+ Per i dettagli sull'API, consulta [DescribeCopyProductStatus AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-copy-product-status.html)*Command Reference*.
### `describe-portfolio`
Il seguente esempio di codice mostra come utilizzare`describe-portfolio`.
**AWS CLI**
**Come descrivere un portafoglio**
L’esempio `describe-portfolio` seguente mostra i dettagli del portafoglio specificato.
```
aws servicecatalog describe-portfolio \
--id port-2s6abcdq5wdh4
```
Output:
```
{
"TagOptions": [],
"PortfolioDetail": {
"ARN": "arn:aws:catalog:us-west-2:687558541234:portfolio/port-2s6abcdq5wdh4",
"Id": "port-2s6wuzyq5wdh4",
"CreatedTime": 1571337221.555,
"DisplayName": "my-portfolio",
"ProviderName": "my-provider"
},
"Tags": []
}
```
+ Per i dettagli sull'API, consulta [DescribePortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-portfolio.html)*Command Reference*.
### `describe-product-as-admin`
Il seguente esempio di codice mostra come utilizzare`describe-product-as-admin`.
**AWS CLI**
**Come descrivere un prodotto come amministratore**
L’esempio `describe-product-as-admin` seguente mostra i dettagli del prodotto specificato utilizzando privilegi da amministratore.
```
aws servicecatalog describe-product-as-admin \
--id prod-abcdcek6yhbxi
```
Output:
```
{
"TagOptions": [],
"ProductViewDetail": {
"ProductARN": "arn:aws:catalog:us-west-2:687558542028:product/prod-abcdcek6yhbxi",
"ProductViewSummary": {
"SupportEmail": "test@amazon.com",
"Type": "CLOUD_FORMATION_TEMPLATE",
"Distributor": "test-distributor",
"ShortDescription": "test-description",
"Owner": "test-owner",
"Id": "prodview-wi3l2j4abc6vc",
"SupportDescription": "test-support",
"ProductId": "prod-abcdcek6yhbxi",
"HasDefaultPath": false,
"Name": "test-product3",
"SupportUrl": "https://aws.amazon.com"
},
"CreatedTime": 1577136715.0,
"Status": "CREATED"
},
"ProvisioningArtifactSummaries": [
{
"CreatedTime": 1577136715.0,
"Description": "test-version-description",
"ProvisioningArtifactMetadata": {
"SourceProvisioningArtifactId": "pa-abcdxkkiv5fcm"
},
"Name": "test-version-name-3",
"Id": "pa-abcdxkkiv5fcm"
}
],
"Tags": [
{
"Value": "iad",
"Key": "region"
}
]
}
```
+ Per i dettagli sull'API, consulta [DescribeProductAsAdmin AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-product-as-admin.html)*Command Reference*.
### `describe-provisioned-product`
Il seguente esempio di codice mostra come utilizzare`describe-provisioned-product`.
**AWS CLI**
**Come descrivere un prodotto sottoposto a provisioning**
L’esempio `describe-provisioned-product` seguente mostra i dettagli del prodotto sottoposto a provisioning specificato.
```
aws servicecatalog describe-provisioned-product \
--id pp-dpom27bm4abcd
```
Output:
```
{
"ProvisionedProductDetail": {
"Status": "ERROR",
"CreatedTime": 1577222793.358,
"Arn": "arn:aws:servicecatalog:us-west-2:123456789012:stack/mytestppname3/pp-dpom27bm4abcd",
"Id": "pp-dpom27bm4abcd",
"StatusMessage": "AmazonCloudFormationException Parameters: [KeyName] must have values (Service: AmazonCloudFormation; Status Code: 400; Error Code: ValidationError; Request ID: 5528602a-a9ef-427c-825c-f82c31b814f5)",
"IdempotencyToken": "527c5358-2a1a-4b9e-b1b9-7293b0ddff42",
"LastRecordId": "rec-tfuawdjovzxge",
"Type": "CFN_STACK",
"Name": "mytestppname3"
},
"CloudWatchDashboards": []
}
```
+ Per i dettagli sull'API, consulta [DescribeProvisionedProduct AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-provisioned-product.html)*Command Reference*.
### `describe-provisioning-artifact`
Il seguente esempio di codice mostra come utilizzare`describe-provisioning-artifact`.
**AWS CLI**
**Come descrivere un artefatto di provisioning**
L’esempio `describe-provisioning-artifact` seguente mostra i dettagli dell’artefatto sottoposto a provisioning specificato.
```
aws servicecatalog describe-provisioning-artifact \
--provisioning-artifact-id pa-pcz347abcdcfm \
--product-id prod-abcdfz3syn2rg
```
Output:
```
{
"Info": {
"TemplateUrl": "https://awsdocs.s3.amazonaws.com/servicecatalog/myexampledevelopment-environment.template"
},
"ProvisioningArtifactDetail": {
"Id": "pa-pcz347abcdcfm",
"Active": true,
"Type": "CLOUD_FORMATION_TEMPLATE",
"Description": "updated description",
"CreatedTime": 1562097906.0,
"Name": "updated name"
},
"Status": "AVAILABLE"
}
```
+ Per i dettagli sull'API, consulta [DescribeProvisioningArtifact AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-provisioning-artifact.html)*Command Reference*.
### `describe-tag-option`
Il seguente esempio di codice mostra come utilizzare`describe-tag-option`.
**AWS CLI**
**Per descrivere un TagOption**
L'`describe-tag-option`esempio seguente visualizza i dettagli relativi a quanto specificato TagOption.
```
aws servicecatalog describe-tag-option \
--id tag-p3tej2abcd5qc
```
Output:
```
{
"TagOptionDetail": {
"Active": true,
"Id": "tag-p3tej2abcd5qc",
"Value": "value-3",
"Key": "1234"
}
}
```
+ Per i dettagli sull'API, vedere [DescribeTagOption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-tag-option.html)in *AWS CLI Command Reference*.
### `disassociate-principal-from-portfolio`
Il seguente esempio di codice mostra come utilizzare`disassociate-principal-from-portfolio`.
**AWS CLI**
**Come annullare l’associazione di un principale a un portafoglio**
L’esempio `disassociate-principal-from-portfolio` seguente annulla l’associazione del principale specificato al portafoglio.
```
aws servicecatalog disassociate-principal-from-portfolio \
--portfolio-id port-2s6abcdq5wdh4 \
--principal-arn arn:aws:iam::123456789012:group/myendusers
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DisassociatePrincipalFromPortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/disassociate-principal-from-portfolio.html)*Command Reference*.
### `disassociate-product-from-portfolio`
Il seguente esempio di codice mostra come utilizzare`disassociate-product-from-portfolio`.
**AWS CLI**
**Come annullare l’associazione di un prodotto a un portafoglio**
L’esempio `disassociate-product-from-portfolio` seguente annulla l’associazione del prodotto specificato al portafoglio.
```
aws servicecatalog disassociate-product-from-portfolio \
--product-id prod-3p5abcdmu3oyk \
--portfolio-id port-2s6abcdq5wdh4
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DisassociateProductFromPortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/disassociate-product-from-portfolio.html)*Command Reference*.
### `disassociate-tag-option-from-resource`
Il seguente esempio di codice mostra come utilizzare`disassociate-tag-option-from-resource`.
**AWS CLI**
**Dissociare un TagOption da una risorsa**
L’esempio `disassociate-tag-option-from-resource` seguente annulla l’associazione del `TagOption` specificato al portafoglio.
```
aws servicecatalog disassociate-tag-option-from-resource \
--resource-id port-2s6abcdq5wdh4 \
--tag-option-id tag-p3abc2pkpz5qc
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DisassociateTagOptionFromResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/disassociate-tag-option-from-resource.html)*Command Reference.*
### `list-accepted-portfolio-shares`
Il seguente esempio di codice mostra come utilizzare`list-accepted-portfolio-shares`.
**AWS CLI**
**Come elencare le condivisioni di portafoglio accettate**
L’esempio `list-accepted-portfolio-shares` seguente elenca tutti i portafogli per i quali la condivisione è stata accettata da questo account, includendo solo i portafogli predefiniti di Catalogo dei servizi.
```
aws servicecatalog list-accepted-portfolio-shares \
--portfolio-share-type "AWS_SERVICECATALOG"
```
Output:
```
{
"PortfolioDetails": [
{
"ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-d2abcd5dpkuma",
"Description": "AWS Service Catalog Reference blueprints for often-used AWS services such as EC2, S3, RDS, VPC and EMR.",
"CreatedTime": 1574456190.687,
"ProviderName": "AWS Service Catalog",
"DisplayName": "Reference Architectures",
"Id": "port-d2abcd5dpkuma"
},
{
"ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-abcdefaua7zpu",
"Description": "AWS well-architected blueprints for high reliability applications.",
"CreatedTime": 1574461496.092,
"ProviderName": "AWS Service Catalog",
"DisplayName": "High Reliability Architectures",
"Id": "port-abcdefaua7zpu"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListAcceptedPortfolioShares AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-accepted-portfolio-shares.html)*Command Reference*.
### `list-portfolio-access`
Il seguente esempio di codice mostra come utilizzare`list-portfolio-access`.
**AWS CLI**
**Come elencare gli account con accesso a un portafoglio**
L'`list-portfolio-access`esempio seguente elenca gli AWS account che hanno accesso al portafoglio specificato.
```
aws servicecatalog list-portfolio-access \
--portfolio-id port-2s6abcdq5wdh4
```
Output:
```
{
"AccountIds": [
"123456789012"
]
}
```
+ Per i dettagli sull'API, vedere [ListPortfolioAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-portfolio-access.html)in *AWS CLI Command Reference*.
### `list-portfolios-for-product`
Il seguente esempio di codice mostra come utilizzare`list-portfolios-for-product`.
**AWS CLI**
**Come elencare i portafogli associati a un prodotto**
L’esempio `list-portfolios-for-product` seguente elenca i portafogli associati al prodotto specificato.
```
aws servicecatalog list-portfolios-for-product \
--product-id prod-abcdfz3syn2rg
```
Output:
```
{
"PortfolioDetails": [
{
"CreatedTime": 1571337221.555,
"Id": "port-2s6abcdq5wdh4",
"ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-2s6abcdq5wdh4",
"DisplayName": "my-portfolio",
"ProviderName": "my-provider"
},
{
"CreatedTime": 1559665256.348,
"Id": "port-5abcd3e5st4ei",
"ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-5abcd3e5st4ei",
"DisplayName": "test",
"ProviderName": "provider-name"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListPortfoliosForProduct AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-portfolios-for-product.html)*Command Reference*.
### `list-portfolios`
Il seguente esempio di codice mostra come utilizzare`list-portfolios`.
**AWS CLI**
**Come elencare i portafogli**
L’esempio `list-portfolios` seguente elenca i portafogli di Catalogo dei servizi presenti nella Regione corrente.
```
aws servicecatalog list-portfolios
```
Output:
```
{
"PortfolioDetails": [
{
"CreatedTime": 1559665256.348,
"ARN": "arn:aws:catalog:us-east-2:123456789012:portfolio/port-5pzcxmplst4ei",
"DisplayName": "my-portfolio",
"Id": "port-5pzcxmplst4ei",
"ProviderName": "my-user"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListPortfolios AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-portfolios.html)*Command Reference*.
### `list-principals-for-portfolio`
Il seguente esempio di codice mostra come utilizzare`list-principals-for-portfolio`.
**AWS CLI**
**Come elencare tutti i principali per un portafoglio**
L’esempio `list-principals-for-portfolio` seguente elenca tutti i principali del portafoglio specificato.
```
aws servicecatalog list-principals-for-portfolio \
--portfolio-id port-2s6abcdq5wdh4
```
Output:
```
{
"Principals": [
{
"PrincipalARN": "arn:aws:iam::123456789012:user/usertest",
"PrincipalType": "IAM"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListPrincipalsForPortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-principals-for-portfolio.html)*Command Reference*.
### `list-provisioning-artifacts`
Il seguente esempio di codice mostra come utilizzare`list-provisioning-artifacts`.
**AWS CLI**
**Come elencare tutti gli artefatti di provisioning per un prodotto**
L’esempio `list-provisioning-artifacts` seguente elenca tutti gli artefatti di provisioning per il prodotto specificato.
```
aws servicecatalog list-provisioning-artifacts \
--product-id prod-nfi2abcdefgcpw
```
Output:
```
{
"ProvisioningArtifactDetails": [
{
"Id": "pa-abcdef54ipm6z",
"Description": "test-version-description",
"Type": "CLOUD_FORMATION_TEMPLATE",
"CreatedTime": 1576021147.0,
"Active": true,
"Name": "test-version-name"
},
{
"Id": "pa-bb4zyxwwnaio",
"Description": "test description",
"Type": "CLOUD_FORMATION_TEMPLATE",
"CreatedTime": 1576022545.0,
"Active": true,
"Name": "test-provisioning-artifact-2"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListProvisioningArtifacts AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-provisioning-artifacts.html)*Command Reference*.
### `list-resources-for-tag-option`
Il seguente esempio di codice mostra come utilizzare`list-resources-for-tag-option`.
**AWS CLI**
**Per elencare le risorse associate a un TagOption**
L’esempio `list-resources-for-tag-option` seguente elenca le risorse associate al `TagOption` specificato.
```
aws servicecatalog list-resources-for-tag-option \
--tag-option-id tag-p3tej2abcd5qc
```
Output:
```
{
"ResourceDetails": [
{
"ARN": "arn:aws:catalog:us-west-2:123456789012:product/prod-abcdfz3syn2rg",
"Name": "my product",
"Description": "description",
"CreatedTime": 1562097906.0,
"Id": "prod-abcdfz3syn2rg"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListResourcesForTagOption AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-resources-for-tag-option.html)*Command Reference*.
### `list-tag-options`
Il seguente esempio di codice mostra come utilizzare`list-tag-options`.
**AWS CLI**
L’esempio `list-tag-options` seguente elenca tutti i valori per `TagOptions`.
```
aws servicecatalog list-tag-options
```
Output:
```
{
"TagOptionDetails": [
{
"Value": "newvalue",
"Active": true,
"Id": "tag-iabcdn4fzjjms",
"Key": "1234"
},
{
"Value": "value1",
"Active": true,
"Id": "tag-e3abcdvmwvrzy",
"Key": "key"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListTagOptions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-tag-options.html)*Command Reference*.
### `provision-product`
Il seguente esempio di codice mostra come utilizzare`provision-product`.
**AWS CLI**
**Come eseguire il provisioning di un prodotto**
L’esempio `provision-product` seguente esegue il provisioning del prodotto specificato utilizzando l’artefatto di provisioning specificato.
```
aws servicecatalog provision-product \
--product-id prod-abcdfz3syn2rg \
--provisioning-artifact-id pa-abc347pcsccfm \
--provisioned-product-name "mytestppname3"
```
Output:
```
{
"RecordDetail": {
"RecordId": "rec-tfuawdabcdege",
"CreatedTime": 1577222793.362,
"ProvisionedProductId": "pp-abcd27bm4mldq",
"PathId": "lpv2-abcdg3jp6t5k6",
"RecordErrors": [],
"ProductId": "prod-abcdfz3syn2rg",
"UpdatedTime": 1577222793.362,
"RecordType": "PROVISION_PRODUCT",
"ProvisionedProductName": "mytestppname3",
"ProvisioningArtifactId": "pa-pcz347abcdcfm",
"RecordTags": [],
"Status": "CREATED",
"ProvisionedProductType": "CFN_STACK"
}
}
```
+ Per i dettagli sull'API, consulta [ProvisionProduct AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/provision-product.html)*Command Reference*.
### `reject-portfolio-share`
Il seguente esempio di codice mostra come utilizzare`reject-portfolio-share`.
**AWS CLI**
**Come rifiutare una condivisione di portafoglio**
L’esempio `reject-portfolio-share` seguente rifiuta la condivisione del portafoglio indicato.
```
aws servicecatalog reject-portfolio-share \
--portfolio-id port-2s6wuabcdefghijk
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [RejectPortfolioShare AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/reject-portfolio-share.html)*Command Reference*.
### `scan-provisioned-products`
Il seguente esempio di codice mostra come utilizzare`scan-provisioned-products`.
**AWS CLI**
**Come elencare tutti i prodotti sottoposti a provisioning disponibili**
L’esempio `scan-provisioned-products` seguente elenca i prodotti sottoposti a provisioning disponibili.
```
aws servicecatalog scan-provisioned-products
```
Output:
```
{
"ProvisionedProducts": [
{
"Status": "ERROR",
"Arn": "arn:aws:servicecatalog:us-west-2:123456789012:stack/mytestppname3/pp-abcd27bm4mldq",
"StatusMessage": "AmazonCloudFormationException Parameters: [KeyName] must have values (Service: AmazonCloudFormation; Status Code: 400; Error Code: ValidationError; Request ID: 5528602a-a9ef-427c-825c-f82c31b814f5)",
"Id": "pp-abcd27bm4mldq",
"Type": "CFN_STACK",
"IdempotencyToken": "527c5358-2a1a-4b9e-b1b9-7293b0ddff42",
"CreatedTime": 1577222793.358,
"Name": "mytestppname3",
"LastRecordId": "rec-tfuawdabcdxge"
}
]
}
```
+ Per i dettagli sull'API, consulta [ScanProvisionedProducts AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/scan-provisioned-products.html)*Command Reference*.
### `search-products-as-admin`
Il seguente esempio di codice mostra come utilizzare`search-products-as-admin`.
**AWS CLI**
**Come cercare prodotti con privilegi da amministratore**
L’esempio `search-products-as-admin` seguente cerca prodotti con privilegi da amministratore, utilizzando un ID portafoglio come filtro.
```
aws servicecatalog search-products-as-admin \
--portfolio-id port-5abcd3e5st4ei
```
Output:
```
{
"ProductViewDetails": [
{
"ProductViewSummary": {
"Name": "my product",
"Owner": "owner name",
"Type": "CLOUD_FORMATION_TEMPLATE",
"ProductId": "prod-abcdfz3syn2rg",
"HasDefaultPath": false,
"Id": "prodview-abcdmyuzv2dlu",
"ShortDescription": "description"
},
"ProductARN": "arn:aws:catalog:us-west-2:123456789012:product/prod-abcdfz3syn2rg",
"CreatedTime": 1562097906.0,
"Status": "CREATED"
}
]
}
```
+ Per i dettagli sull'API, consulta [SearchProductsAsAdmin AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/search-products-as-admin.html)*Command Reference*.
### `search-provisioned-products`
Il seguente esempio di codice mostra come utilizzare`search-provisioned-products`.
**AWS CLI**
**Come cercare i prodotti sottoposti a provisioning**
L’esempio `search-provisioned-products` seguente cerca i prodotti sottoposti a provisioning corrispondenti all’ID prodotto specificato, utilizzando un file JSON per passare i parametri.
```
aws servicecatalog search-provisioned-products \
--cli-input-json file://search-provisioned-products-input.json
```
Contenuto di `search-provisioned-products-input.json`:
```
{
"Filters": {
"SearchQuery": [
"prod-tcjvfz3syn2rg"
]
}
}
```
Output:
```
{
"ProvisionedProducts": [
{
"ProvisioningArtifactId": "pa-pcz347abcdcfm",
"Name": "mytestppname3",
"CreatedTime": 1577222793.358,
"Id": "pp-abcd27bm4mldq",
"Status": "ERROR",
"UserArn": "arn:aws:iam::123456789012:user/cliuser",
"StatusMessage": "AmazonCloudFormationException Parameters: [KeyName] must have values (Service: AmazonCloudFormation; Status Code: 400; Error Code: ValidationError; Request ID: 5528602a-a9ef-427c-825c-f82c31b814f5)",
"Arn": "arn:aws:servicecatalog:us-west-2:123456789012:stack/mytestppname3/pp-abcd27bm4mldq",
"Tags": [
{
"Value": "arn:aws:catalog:us-west-2:123456789012:product/prod-abcdfz3syn2rg",
"Key": "aws:servicecatalog:productArn"
},
{
"Value": "arn:aws:iam::123456789012:user/cliuser",
"Key": "aws:servicecatalog:provisioningPrincipalArn"
},
{
"Value": "value-3",
"Key": "1234"
},
{
"Value": "pa-pcz347abcdcfm",
"Key": "aws:servicecatalog:provisioningArtifactIdentifier"
},
{
"Value": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-2s6abcdq5wdh4",
"Key": "aws:servicecatalog:portfolioArn"
},
{
"Value": "arn:aws:servicecatalog:us-west-2:123456789012:stack/mytestppname3/pp-abcd27bm4mldq",
"Key": "aws:servicecatalog:provisionedProductArn"
}
],
"IdempotencyToken": "527c5358-2a1a-4b9e-b1b9-7293b0ddff42",
"UserArnSession": "arn:aws:iam::123456789012:user/cliuser",
"Type": "CFN_STACK",
"LastRecordId": "rec-tfuawdabcdxge",
"ProductId": "prod-abcdfz3syn2rg"
}
],
"TotalResultsCount": 1
}
```
+ Per i dettagli sull'API, consulta [SearchProvisionedProducts AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/search-provisioned-products.html)*Command Reference*.
### `update-portfolio`
Il seguente esempio di codice mostra come utilizzare`update-portfolio`.
**AWS CLI**
**Come aggiornare un portafoglio**
L’esempio `update-portfolio` seguente aggiorna il nome del portafoglio specificato.
```
aws servicecatalog update-portfolio \
--id port-5abcd3e5st4ei \
--display-name "New portfolio name"
```
Output:
```
{
"PortfolioDetail": {
"DisplayName": "New portfolio name",
"ProviderName": "provider",
"ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-5abcd3e5st4ei",
"Id": "port-5abcd3e5st4ei",
"CreatedTime": 1559665256.348
},
"Tags": []
}
```
+ Per i dettagli sull'API, consulta [UpdatePortfolio AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-portfolio.html)*Command Reference*.
### `update-product`
Il seguente esempio di codice mostra come utilizzare`update-product`.
**AWS CLI**
**Come aggiornare un prodotto**
L’esempio `update-product` seguente aggiorna il nome e il proprietario del prodotto specificato.
```
aws servicecatalog update-product \
--id prod-os6abc7drqlt2 \
--name "New product name" \
--owner "Updated product owner"
```
Output:
```
{
"Tags": [
{
"Value": "iad",
"Key": "region"
}
],
"ProductViewDetail": {
"ProductViewSummary": {
"Owner": "Updated product owner",
"ProductId": "prod-os6abc7drqlt2",
"Distributor": "test-distributor",
"SupportUrl": "https://aws.amazon.com",
"Name": "New product name",
"ShortDescription": "test-description",
"HasDefaultPath": false,
"Id": "prodview-6abcdgrfhvidy",
"SupportDescription": "test-support",
"SupportEmail": "test@amazon.com",
"Type": "CLOUD_FORMATION_TEMPLATE"
},
"Status": "CREATED",
"ProductARN": "arn:aws:catalog:us-west-2:123456789012:product/prod-os6abc7drqlt2",
"CreatedTime": 1577136255.0
}
}
```
+ Per i dettagli sull'API, consulta [UpdateProduct AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-product.html)*Command Reference*.
### `update-provisioning-artifact`
Il seguente esempio di codice mostra come utilizzare`update-provisioning-artifact`.
**AWS CLI**
**Come aggiornare un artefatto di provisioning**
L’esempio `update-provisioning-artifact` seguente aggiorna il nome e la descrizione dell’artefatto di provisioning specificato, utilizzando un file JSON per passare i parametri.
```
aws servicecatalog update-provisioning-artifact \
--cli-input-json file://update-provisioning-artifact-input.json
```
Contenuto di `update-provisioning-artifact-input.json`:
```
{
"ProductId": "prod-abcdfz3syn2rg",
"ProvisioningArtifactId": "pa-pcz347abcdcfm",
"Name": "updated name",
"Description": "updated description"
}
```
Output:
```
{
"Info": {
"TemplateUrl": "https://awsdocs.s3.amazonaws.com/servicecatalog/myexampledevelopment-environment.template"
},
"Status": "AVAILABLE",
"ProvisioningArtifactDetail": {
"Active": true,
"Description": "updated description",
"Id": "pa-pcz347abcdcfm",
"Name": "updated name",
"Type": "CLOUD_FORMATION_TEMPLATE",
"CreatedTime": 1562097906.0
}
}
```
+ Per i dettagli sull'API, consulta [UpdateProvisioningArtifact AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-provisioning-artifact.html)*Command Reference*.
### `update-tag-option`
Il seguente esempio di codice mostra come utilizzare`update-tag-option`.
**AWS CLI**
**Per aggiornare un TagOption**
L’esempio `update-tag-option` seguente aggiorna il valore di un `TagOption`, utilizzando il file JSON specificato.
```
aws servicecatalog update-tag-option --cli-input-json file://update-tag-option-input.json
```
Contenuto di `update-tag-option-input.json`:
```
{
"Id": "tag-iabcdn4fzjjms",
"Value": "newvalue",
"Active": true
}
```
Output:
```
{
"TagOptionDetail": {
"Value": "newvalue",
"Key": "1234",
"Active": true,
"Id": "tag-iabcdn4fzjjms"
}
}
```
+ Per i dettagli sull'API, consulta [UpdateTagOption AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-tag-option.html)*Command Reference*.