En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Service Catalog.
Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar accept-portfolio-share
.
- AWS CLI
-
Para aceptar compartir una cartera
En el siguiente ejemplo de
accept-portfolio-share
, se acepta una oferta, realizada por otro usuario, para compartir la cartera especificada.aws servicecatalog accept-portfolio-share \ --portfolio-id
port-2s6wuabcdefghijk
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte AcceptPortfolioShare
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar associate-principal-with-portfolio
.
- AWS CLI
-
Para asociar una entidad principal a una cartera
En el siguiente ejemplo de
associate-principal-with-portfolio
, se asocia un usuario a la cartera especificada.aws servicecatalog associate-principal-with-portfolio \ --portfolio-id
port-2s6abcdefwdh4
\ --principal-arnarn:aws:iam::123456789012:user/usertest
\ --principal-typeIAM
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte AssociatePrincipalWithPortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar associate-product-with-portfolio
.
- AWS CLI
-
Para asociar un producto a una cartera
En el siguiente ejemplo de
associate-product-with-portfolio
, se asocia un producto determinado a la cartera especificada.aws servicecatalog associate-product-with-portfolio --product-id
prod-3p5abcdef3oyk
--portfolio-idport-2s6abcdef5wdh4
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte AssociateProductWithPortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar associate-tag-option-with-resource
.
- AWS CLI
-
Para asociar una TagOption a un recurso
En el siguiente ejemplo de
associate-tag-option-with-resource
, se asocia la TagOption especificada con el recurso especificado.aws servicecatalog associate-tag-option-with-resource \ --resource-id
port-2s6abcdq5wdh4
\ --tag-option-idtag-p3abc2pkpz5qc
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte AssociateTagOptionWithResource
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar copy-product
.
- AWS CLI
-
Para copiar un producto
En el siguiente ejemplo de
copy-product
, se hace una copia del producto especificado con un archivo JSON para pasar los parámetros.aws servicecatalog copy-product --cli-input-json
file://copy-product-input.json
Contenido de
copy-product-input.json
:{ "SourceProductArn": "arn:aws:catalog:us-west-2:123456789012:product/prod-tcabcd3syn2xy", "TargetProductName": "copy-of-myproduct", "CopyOptions": [ "CopyTags" ] }
Salida:
{ "CopyProductToken": "copyproduct-abc5defgjkdji" }
-
Para obtener información sobre la API, consulte CopyProduct
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-portfolio-share
.
- AWS CLI
-
Para compartir una cartera con una cuenta
En el siguiente ejemplo de
create-portfolio-share
, se comparte la cartera especificada con la cuenta especificada.aws servicecatalog create-portfolio-share \ --portfolio-id
port-2s6abcdef5wdh4
\ --account-id794123456789
Este comando no genera ningún resultado.
-
Para obtener información sobre la API, consulte CreatePortfolioShare
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-portfolio
.
- AWS CLI
-
Para crear una cartera
En el siguiente ejemplo de
create-portfolio
, se crea una cartera.aws servicecatalog create-portfolio \ --provider-name
my-provider
\ --display-namemy-portfolio
Salida:
{ "PortfolioDetail": { "ProviderName": "my-provider", "DisplayName": "my-portfolio", "CreatedTime": 1571337221.555, "ARN": "arn:aws:catalog:us-east-2:123456789012:portfolio/port-2s6xmplq5wdh4", "Id": "port-2s6xmplq5wdh4" } }
-
Para obtener información sobre la API, consulte CreatePortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-product
.
- AWS CLI
-
Para crear un producto
En el siguiente ejemplo de
create-product
, se crea un producto con un archivo JSON para pasar los parámetros.aws servicecatalog create-product \ --cli-input-json
file://create-product-input.json
Contenido de
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" } }
Salida:
{ "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" } }
-
Para obtener información sobre la API, consulte CreateProduct
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-provisioning-artifact
.
- AWS CLI
-
Para crear un artefacto de aprovisionamiento
En el siguiente ejemplo de
create-provisioning-artifact
, se crea un artefacto de aprovisionamiento con un archivo JSON para pasar los parámetros.aws servicecatalog create-provisioning-artifact \ --cli-input-json
file://create-provisioning-artifact-input.json
Contenido de
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" } }
Salida:
{ "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 } }
-
Para obtener información sobre la API, consulte CreateProvisioningArtifact
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-tag-option
.
- AWS CLI
-
Para crear una TagOption
En el siguiente ejemplo de
create-tag-option
, se crea una TagOption.aws servicecatalog create-tag-option --key
1234
--valuename
Salida:
{ "TagOptionDetail": { "Id": "tag-iabcdn4fzjjms", "Value": "name", "Active": true, "Key": "1234" } }
-
Para obtener información sobre la API, consulte CreateTagOption
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-portfolio-share
.
- AWS CLI
-
Para dejar de compartir una cartera con una cuenta
En el siguiente ejemplo de
delete-portfolio-share
, se deja de compartir la cartera con la cuenta especificada.aws servicecatalog delete-portfolio-share \ --portfolio-id
port-2s6abcdq5wdh4
\ --account-id123456789012
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DeletePortfolioShare
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-portfolio
.
- AWS CLI
-
Para eliminar una cartera
En el siguiente ejemplo de
delete-portfolio
, se elimina la cartera especificada.aws servicecatalog delete-portfolio \ --id
port-abcdlx4gox4do
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DeletePortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-product
.
- AWS CLI
-
Para eliminar un producto
En el siguiente ejemplo de
delete-product
, se elimina el producto especificado.aws servicecatalog delete-product \ --id
prod-abcdcek6yhbxi
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DeleteProduct
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-provisioning-artifact
.
- AWS CLI
-
Para eliminar un artefacto de aprovisionamiento
En el siguiente ejemplo de
delete-provisioning-artifact
, se elimina el artefacto de aprovisionamiento especificado.aws servicecatalog delete-provisioning-artifact \ --product-id
prod-abc2uebuplcpw
\ --provisioning-artifact-idpa-pqabcddii7ouc
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DeleteProvisioningArtifact
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-tag-option
.
- AWS CLI
-
Para eliminar una TagOption
En el siguiente ejemplo de
delete-tag-option
, se elimina la TagOption especificada.aws servicecatalog delete-tag-option \ --id
tag-iabcdn4fzjjms
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DeleteTagOption
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-copy-product-status
.
- AWS CLI
-
Para describir el estado de la operación de copia del producto
En el siguiente ejemplo de
describe-copy-product-status
, se muestra el estado actual de la operación de copia asíncrona del producto especificada.aws servicecatalog describe-copy-product-status \ --copy-product-token
copyproduct-znn5tf5abcd3w
Salida:
{ "CopyProductStatus": "SUCCEEDED", "TargetProductId": "prod-os6hog7abcdt2" }
-
Para obtener información sobre la API, consulte DescribeCopyProductStatus
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-portfolio
.
- AWS CLI
-
Para describir una cartera
En el siguiente ejemplo de
describe-portfolio
, se muestran los detalles de la cartera especificada.aws servicecatalog describe-portfolio \ --id
port-2s6abcdq5wdh4
Salida:
{ "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": [] }
-
Para obtener información sobre la API, consulte DescribePortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-product-as-admin
.
- AWS CLI
-
Para describir un producto como administrador
En el siguiente ejemplo de
describe-product-as-admin
, se muestran los detalles del producto especificado mediante los privilegios de administrador.aws servicecatalog describe-product-as-admin \ --id
prod-abcdcek6yhbxi
Salida:
{ "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" } ] }
-
Para obtener detalles sobre la API, consulte DescribeProductAsAdmin
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-provisioned-product
.
- AWS CLI
-
Para describir un producto aprovisionado
En el siguiente ejemplo de
describe-provisioned-product
, se muestran los detalles del producto de aprovisionamiento especificado.aws servicecatalog describe-provisioned-product \ --id
pp-dpom27bm4abcd
Salida:
{ "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": [] }
-
Para obtener información sobre la API, consulte DescribeProvisionedProduct
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-provisioning-artifact
.
- AWS CLI
-
Para describir un artefacto de aprovisionamiento
En el siguiente ejemplo de
describe-provisioning-artifact
, se muestran los detalles del artefacto de aprovisionamiento especificado.aws servicecatalog describe-provisioning-artifact \ --provisioning-artifact-id
pa-pcz347abcdcfm
\ --product-idprod-abcdfz3syn2rg
Salida:
{ "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" }
-
Para obtener información sobre la API, consulte DescribeProvisioningArtifact
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-tag-option
.
- AWS CLI
-
Para describir una TagOption
En el siguiente ejemplo de
describe-tag-option
, se muestran los detalles de la TagOption especificada.aws servicecatalog describe-tag-option \ --id
tag-p3tej2abcd5qc
Salida:
{ "TagOptionDetail": { "Active": true, "Id": "tag-p3tej2abcd5qc", "Value": "value-3", "Key": "1234" } }
-
Para obtener información sobre la API, consulte DescribeTagOption
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar disassociate-principal-from-portfolio
.
- AWS CLI
-
Para desasociar una entidad principal de una cartera
En el siguiente ejemplo de
disassociate-principal-from-portfolio
, se desvincula la entidad principal especificada de la cartera.aws servicecatalog disassociate-principal-from-portfolio \ --portfolio-id
port-2s6abcdq5wdh4
\ --principal-arnarn:aws:iam::123456789012:group/myendusers
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DisassociatePrincipalFromPortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar disassociate-product-from-portfolio
.
- AWS CLI
-
Para desasociar un producto de una cartera
En el siguiente ejemplo de
disassociate-product-from-portfolio
, se desvincula el producto especificado de la cartera.aws servicecatalog disassociate-product-from-portfolio \ --product-id
prod-3p5abcdmu3oyk
\ --portfolio-idport-2s6abcdq5wdh4
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DisassociateProductFromPortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar disassociate-tag-option-from-resource
.
- AWS CLI
-
Para desasociar una TagOption de un recurso
En el siguiente ejemplo de
disassociate-tag-option-from-resource
, se desvincula laTagOption
especificada del recurso.aws servicecatalog disassociate-tag-option-from-resource \ --resource-id
port-2s6abcdq5wdh4
\ --tag-option-idtag-p3abc2pkpz5qc
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DisassociateTagOptionFromResource
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-accepted-portfolio-shares
.
- AWS CLI
-
Para enumerar las carpetas de la cartera compartidas
En el siguiente ejemplo de
list-accepted-portfolio-shares
, se enumeran todas las carteras que esta cuenta ha aceptado compartir, incluidas únicamente las carteras predeterminadas de Service Catalog.aws servicecatalog list-accepted-portfolio-shares \ --portfolio-share-type
"AWS_SERVICECATALOG"
Salida:
{ "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" } ] }
-
Para obtener información sobre la API, consulte ListAcceptedPortfolioShares
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-portfolio-access
.
- AWS CLI
-
Para enumerar las cuentas con acceso a una cartera
En el siguiente ejemplo de
list-portfolio-access
, se enumeran las cuentas de AWS que tienen acceso a la cartera especificada.aws servicecatalog list-portfolio-access \ --portfolio-id
port-2s6abcdq5wdh4
Salida:
{ "AccountIds": [ "123456789012" ] }
-
Para obtener información sobre la API, consulte ListPortfolioAccess
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-portfolios-for-product
.
- AWS CLI
-
Para asociar las carteras asociadas a un producto
En el siguiente ejemplo de
list-portfolios-for-product
, se enumeran las carteras asociadas a un producto determinado.aws servicecatalog list-portfolios-for-product \ --product-id
prod-abcdfz3syn2rg
Salida:
{ "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" } ] }
-
Para obtener detalles sobre la API, consulte ListPortfoliosForProduct
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-portfolios
.
- AWS CLI
-
Para enumerar carteras
En el siguiente ejemplo de
list-portfolios
, se enumeran las carteras de Service Catalog de la región actual.aws servicecatalog list-portfolios
Salida:
{ "PortfolioDetails": [ { "CreatedTime": 1559665256.348, "ARN": "arn:aws:catalog:us-east-2:123456789012:portfolio/port-5pzcxmplst4ei", "DisplayName": "my-portfolio", "Id": "port-5pzcxmplst4ei", "ProviderName": "my-user" } ] }
-
Para obtener detalles de la API, consulte ListPortfolios
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-principals-for-portfolio
.
- AWS CLI
-
Para enumerar todas las entidades principales de una cartera
En el siguiente ejemplo de
list-principals-for-portfolio
, se enumeran todas las entidades principales de la cartera especificada.aws servicecatalog list-principals-for-portfolio \ --portfolio-id
port-2s6abcdq5wdh4
Salida:
{ "Principals": [ { "PrincipalARN": "arn:aws:iam::123456789012:user/usertest", "PrincipalType": "IAM" } ] }
-
Para obtener información sobre la API, consulte ListPrincipalsForPortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-provisioning-artifacts
.
- AWS CLI
-
Para enumerar todos los artefactos de aprovisionamiento de un producto
En el siguiente ejemplo de
list-provisioning-artifacts
, se enumeran los artefactos de aprovisionamiento del producto especificado.aws servicecatalog list-provisioning-artifacts \ --product-id
prod-nfi2abcdefgcpw
Salida:
{ "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" } ] }
-
Para obtener información sobre la API, consulte ListProvisioningArtifacts
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-resources-for-tag-option
.
- AWS CLI
-
Para enumerar los recursos asociados a una TagOption
En el siguiente ejemplo de
list-resources-for-tag-option
, se enumeran los recursos asociados a laTagOption
especificada.aws servicecatalog list-resources-for-tag-option \ --tag-option-id
tag-p3tej2abcd5qc
Salida:
{ "ResourceDetails": [ { "ARN": "arn:aws:catalog:us-west-2:123456789012:product/prod-abcdfz3syn2rg", "Name": "my product", "Description": "description", "CreatedTime": 1562097906.0, "Id": "prod-abcdfz3syn2rg" } ] }
-
Para obtener información sobre la API, consulte ListResourcesForTagOption
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-tag-options
.
- AWS CLI
-
En el siguiente ejemplo de
list-tag-options
, se enumeran todos los valores deTagOptions
.aws servicecatalog list-tag-options
Salida:
{ "TagOptionDetails": [ { "Value": "newvalue", "Active": true, "Id": "tag-iabcdn4fzjjms", "Key": "1234" }, { "Value": "value1", "Active": true, "Id": "tag-e3abcdvmwvrzy", "Key": "key" } ] }
-
Para obtener detalles de la API, consulte ListTagOptions
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar provision-product
.
- AWS CLI
-
Para aprovisionar un producto
En el siguiente ejemplo de
provision-product
, se aprovisiona el producto especificado mediante el artefacto de aprovisionamiento indicado.aws servicecatalog provision-product \ --product-id
prod-abcdfz3syn2rg
\ --provisioning-artifact-idpa-abc347pcsccfm
\ --provisioned-product-name"mytestppname3"
Salida:
{ "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" } }
-
Para obtener detalles de la API, consulte ProvisionProduct
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar reject-portfolio-share
.
- AWS CLI
-
Para no compartir una cartera
En el siguiente ejemplo de
reject-portfolio-share
, se rechaza el recurso compartido de una cartera determinada.aws servicecatalog reject-portfolio-share \ --portfolio-id
port-2s6wuabcdefghijk
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte RejectPortfolioShare
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar scan-provisioned-products
.
- AWS CLI
-
Para ver una lista de todos los productos aprovisionados disponibles
En el siguiente ejemplo de
scan-provisioned-products
, se enumeran los productos aprovisionados disponibles.aws servicecatalog scan-provisioned-products
Salida:
{ "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" } ] }
-
Para obtener información sobre la API, consulte ScanProvisionedProducts
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar search-products-as-admin
.
- AWS CLI
-
Para buscar productos con privilegios de administrador
En el siguiente ejemplo de
search-products-as-admin
, se buscan productos con privilegios de administrador con un ID de cartera como filtro.aws servicecatalog search-products-as-admin \ --portfolio-id
port-5abcd3e5st4ei
Salida:
{ "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" } ] }
-
Para obtener información sobre la API, consulte SearchProductsAsAdmin
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar search-provisioned-products
.
- AWS CLI
-
Para buscar productos aprovisionados
En el siguiente ejemplo de
search-provisioned-products
, se buscan productos aprovisionados que coincidan con el ID de producto especificado mediante un archivo JSON para pasar los parámetros.aws servicecatalog search-provisioned-products \ --cli-input-json
file://search-provisioned-products-input.json
Contenido de
search-provisioned-products-input.json
:{ "Filters": { "SearchQuery": [ "prod-tcjvfz3syn2rg" ] } }
Salida:
{ "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 }
-
Para obtener información sobre la API, consulte SearchProvisionedProducts
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-portfolio
.
- AWS CLI
-
Para actualizar una cartera
En el siguiente ejemplo de
update-portfolio
, se actualiza el nombre de la cartera especificada.aws servicecatalog update-portfolio \ --id
port-5abcd3e5st4ei
\ --display-name"New portfolio name"
Salida:
{ "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": [] }
-
Para obtener información sobre la API, consulte UpdatePortfolio
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-product
.
- AWS CLI
-
Para actualizar un producto
En el siguiente ejemplo de
update-product
, se actualiza el nombre y el propietario de la cartera especificada.aws servicecatalog update-product \ --id
prod-os6abc7drqlt2
\ --name"New product name"
\ --owner"Updated product owner"
Salida:
{ "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 } }
-
Para obtener información sobre la API, consulte UpdateProduct
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-provisioning-artifact
.
- AWS CLI
-
Para actualizar un artefacto de aprovisionamiento
En el siguiente ejemplo de
update-provisioning-artifact
, se actualiza el nombre y la descripción del artefacto de aprovisionamiento especificado con un archivo JSON para pasar los parámetros.aws servicecatalog update-provisioning-artifact \ --cli-input-json
file://update-provisioning-artifact-input.json
Contenido de
update-provisioning-artifact-input.json
:{ "ProductId": "prod-abcdfz3syn2rg", "ProvisioningArtifactId": "pa-pcz347abcdcfm", "Name": "updated name", "Description": "updated description" }
Salida:
{ "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 } }
-
Para obtener información sobre la API, consulte UpdateProvisioningArtifact
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-tag-option
.
- AWS CLI
-
Para actualizar una TagOption
En el siguiente ejemplo de
update-tag-option
, se actualiza el valorTagOption
mediante el archivo JSON especificado.aws servicecatalog update-tag-option --cli-input-json
file://update-tag-option-input.json
Contenido de
update-tag-option-input.json
:{ "Id": "tag-iabcdn4fzjjms", "Value": "newvalue", "Active": true }
Salida:
{ "TagOptionDetail": { "Value": "newvalue", "Key": "1234", "Active": true, "Id": "tag-iabcdn4fzjjms" } }
-
Para obtener información sobre la API, consulte UpdateTagOption
en la Referencia de la API de la AWS CLI.
-