Esempi di Service Catalog utilizzando AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi AWS SDK nel repository AWS Doc SDK 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 operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareaccept-portfolio-share.

AWS CLI

Accettare una quota di portafoglio

L'accept-portfolio-shareesempio seguente accetta un'offerta, fatta da un altro utente, per condividere il portafoglio specificato.

aws servicecatalog accept-portfolio-share \
    --portfolio-id port-2s6wuabcdefghijk

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzareassociate-principal-with-portfolio.

AWS CLI

Associare un principale a un portafoglio

L'associate-principal-with-portfolioesempio 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.

Il seguente esempio di codice mostra come utilizzareassociate-product-with-portfolio.

AWS CLI

Associare un prodotto a un portafoglio

L'associate-product-with-portfolioesempio seguente associa il prodotto dato al portafoglio specificato.

aws servicecatalog associate-product-with-portfolio
     --product-id prod-3p5abcdef3oyk
     --portfolio-id port-2s6abcdef5wdh4

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzareassociate-tag-option-with-resource.

AWS CLI

Associare un a TagOption a una risorsa

L'associate-tag-option-with-resourceesempio 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.

Il seguente esempio di codice mostra come utilizzarecopy-product.

AWS CLI

Per copiare un prodotto

L'copy-productesempio 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, vedere CopyProductin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-portfolio-share.

AWS CLI

Per condividere un portafoglio con un account

L'create-portfolio-shareesempio seguente condivide il portafoglio specificato con il conto specificato.

aws servicecatalog create-portfolio-share \
    --portfolio-id port-2s6abcdef5wdh4 \
    --account-id 794123456789

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzarecreate-portfolio.

AWS CLI

Per creare un portfolio

L'create-portfolioesempio seguente crea un portfolio.

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, vedere CreatePortfolioin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-product.

AWS CLI

Per creare un prodotto

L'create-productesempio 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"
    }
}

Il seguente esempio di codice mostra come utilizzarecreate-provisioning-artifact.

AWS CLI

Per creare un artefatto di approvvigionamento

L'create-provisioning-artifactesempio 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
    }
}

Il seguente esempio di codice mostra come utilizzarecreate-tag-option.

AWS CLI

Per creare un TagOption

L'create-tag-optionesempio 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 CreateTagOptionin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-portfolio-share.

AWS CLI

Per interrompere la condivisione di un portafoglio con un account

L'delete-portfolio-shareesempio 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.

Il seguente esempio di codice mostra come utilizzaredelete-portfolio.

AWS CLI

Per eliminare un portfolio

L'delete-portfolioesempio seguente elimina il portfolio specificato.

aws servicecatalog delete-portfolio \
    --id port-abcdlx4gox4do

Questo comando non produce alcun output.

  • Per i dettagli sull'API, vedere DeletePortfolioin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-product.

AWS CLI

Per eliminare un prodotto

L'delete-productesempio seguente elimina il prodotto specificato.

aws servicecatalog delete-product \
    --id prod-abcdcek6yhbxi

Questo comando non produce alcun output.

  • Per i dettagli sull'API, vedere DeleteProductin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-provisioning-artifact.

AWS CLI

Per eliminare un elemento di approvvigionamento

L'delete-provisioning-artifactesempio 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.

Il seguente esempio di codice mostra come utilizzaredelete-tag-option.

AWS CLI

Per eliminare un TagOption

L'delete-tag-optionesempio 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 DeleteTagOptionin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredescribe-copy-product-status.

AWS CLI

Per descrivere lo stato dell'operazione di copia del prodotto

L'describe-copy-product-statusesempio seguente visualizza lo stato corrente dell'operazione di copia asincrona specificata del prodotto.

aws servicecatalog describe-copy-product-status \
    --copy-product-token copyproduct-znn5tf5abcd3w

Output:

{
    "CopyProductStatus": "SUCCEEDED",
    "TargetProductId": "prod-os6hog7abcdt2"
}

Il seguente esempio di codice mostra come utilizzaredescribe-portfolio.

AWS CLI

Per descrivere un portfolio

L'describe-portfolioesempio 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": []
}

Il seguente esempio di codice mostra come utilizzaredescribe-product-as-admin.

AWS CLI

Descrivere un prodotto come amministratore

L'describe-product-as-adminesempio seguente visualizza i dettagli del prodotto specificato utilizzando i privilegi di 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzaredescribe-provisioned-product.

AWS CLI

Per descrivere un prodotto fornito

L'describe-provisioned-productesempio seguente visualizza i dettagli del prodotto fornito 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": []
}

Il seguente esempio di codice mostra come utilizzaredescribe-provisioning-artifact.

AWS CLI

Per descrivere un elemento di approvvigionamento

L'describe-provisioning-artifactesempio seguente visualizza i dettagli per l'artefatto di 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"
}

Il seguente esempio di codice mostra come utilizzaredescribe-tag-option.

AWS CLI

Per descrivere un TagOption

L'describe-tag-optionesempio 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"
    }
}

Il seguente esempio di codice mostra come utilizzaredisassociate-principal-from-portfolio.

AWS CLI

Dissociare un principale da un portafoglio

L'disassociate-principal-from-portfolioesempio seguente dissocia il capitale specificato dal 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.

Il seguente esempio di codice mostra come utilizzaredisassociate-product-from-portfolio.

AWS CLI

Dissociare un prodotto da un portafoglio

L'disassociate-product-from-portfolioesempio seguente dissocia il prodotto specificato dal portafoglio.

aws servicecatalog disassociate-product-from-portfolio \
    --product-id prod-3p5abcdmu3oyk \
    --portfolio-id port-2s6abcdq5wdh4

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzaredisassociate-tag-option-from-resource.

AWS CLI

Dissociare un TagOption da una risorsa

L'disassociate-tag-option-from-resourceesempio seguente dissocia la risorsa specificata TagOption dalla risorsa.

aws servicecatalog disassociate-tag-option-from-resource \
     --resource-id port-2s6abcdq5wdh4 \
     --tag-option-id tag-p3abc2pkpz5qc

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzarelist-accepted-portfolio-shares.

AWS CLI

Per elencare le azioni di portafoglio accettate

L'list-accepted-portfolio-sharesesempio seguente elenca tutti i portafogli per i quali la condivisione è stata accettata da questo account, inclusi solo i portafogli predefiniti del Service Catalog.

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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-portfolio-access.

AWS CLI

Per elencare gli account con accesso a un portafoglio

L'list-portfolio-accessesempio seguente elenca gli AWS account che hanno accesso al portafoglio specificato.

aws servicecatalog list-portfolio-access \
    --portfolio-id port-2s6abcdq5wdh4

Output:

{
    "AccountIds": [
        "123456789012"
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-portfolios-for-product.

AWS CLI

Per elencare i portafogli associati a un prodotto

L'list-portfolios-for-productesempio 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-portfolios.

AWS CLI

Per elencare i portafogli

L'list-portfoliosesempio seguente elenca i portafogli Service Catalog 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, vedere ListPortfoliosin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-principals-for-portfolio.

AWS CLI

Per elencare tutti i principi di un portfolio

L'list-principals-for-portfolioesempio seguente elenca tutti i principali per il portafoglio specificato.

aws servicecatalog list-principals-for-portfolio \
    --portfolio-id port-2s6abcdq5wdh4

Output:

{
    "Principals": [
        {
            "PrincipalARN": "arn:aws:iam::123456789012:user/usertest",
            "PrincipalType": "IAM"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-provisioning-artifacts.

AWS CLI

Per elencare tutti gli elementi di approvvigionamento per un prodotto

L'list-provisioning-artifactsesempio seguente elenca tutti gli artefatti di approvvigionamento 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-resources-for-tag-option.

AWS CLI

Per elencare le risorse associate a un TagOption

L'list-resources-for-tag-optionesempio seguente elenca le risorse associate a quanto specificatoTagOption.

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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-tag-options.

AWS CLI

L'list-tag-optionsesempio seguente elenca tutti i valori perTagOptions.

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, vedere ListTagOptionsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareprovision-product.

AWS CLI

Fornire un prodotto

L'provision-productesempio seguente effettua il provisioning del prodotto specificato utilizzando l'artefatto di approvvigionamento 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"
    }
}

Il seguente esempio di codice mostra come utilizzarereject-portfolio-share.

AWS CLI

Rifiutare una quota di portafoglio

L'reject-portfolio-shareesempio seguente rifiuta la quota di portafoglio per il portafoglio specificato.

aws servicecatalog reject-portfolio-share \
    --portfolio-id port-2s6wuabcdefghijk

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzarescan-provisioned-products.

AWS CLI

Per elencare tutti i prodotti forniti disponibili

L'scan-provisioned-productsesempio seguente elenca i prodotti forniti 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzaresearch-products-as-admin.

AWS CLI

Per cercare prodotti con privilegi di amministratore

L'search-products-as-adminesempio seguente cerca prodotti con privilegi di amministratore, utilizzando un ID di 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzaresearch-provisioned-products.

AWS CLI

Per cercare prodotti forniti

L'search-provisioned-productsesempio seguente cerca i prodotti forniti che corrispondono all'ID del 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
}

Il seguente esempio di codice mostra come utilizzareupdate-portfolio.

AWS CLI

Per aggiornare un portfolio

L'update-portfolioesempio seguente aggiorna il nome del portfolio 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, vedere UpdatePortfolioin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupdate-product.

AWS CLI

Per aggiornare un prodotto

L'update-productesempio 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, vedere UpdateProductin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupdate-provisioning-artifact.

AWS CLI

Per aggiornare un elemento di provisioning

L'update-provisioning-artifactesempio seguente aggiorna il nome e la descrizione dell'elemento 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
    }
}

Il seguente esempio di codice mostra come utilizzareupdate-tag-option.

AWS CLI

Per aggiornare un TagOption

L'update-tag-optionesempio seguente aggiorna il valore di aTagOption, 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, vedere UpdateTagOptionin AWS CLI Command Reference.