# Ejemplos de Service Catalog que utilizan la AWS CLI
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.
**Topics**
+ [Acciones](#actions)
## Acciones
### `accept-portfolio-share`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/accept-portfolio-share.html) en la *Referencia de comandos de la AWS CLI*.
### `associate-principal-with-portfolio`
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-arn {{arn:aws:iam::123456789012:user/usertest}} \
--principal-type {{IAM}}
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [AssociatePrincipalWithPortfolio](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/associate-principal-with-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `associate-product-with-portfolio`
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-id {{port-2s6abcdef5wdh4}}
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [AssociateProductWithPortfolio](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/associate-product-with-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `associate-tag-option-with-resource`
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-id {{tag-p3abc2pkpz5qc}}
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [AssociateTagOptionWithResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/associate-tag-option-with-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `copy-product`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/copy-product.html) en la *Referencia de comandos de la AWS CLI*.
### `create-constraint`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-constraint`.
**AWS CLI**
**Creación de una restricción**
En el ejemplo de `create-constraint` siguiente, se crea una restricción.
```
aws servicecatalog create-constraint \
--portfolio-id {{port-y3fnkesxxxxx}} \
--product-id {{prod-cfrfxmraxxxxx}} \
--type {{LAUNCH}} \
--parameters '{{{"RoleArn" : "arn:aws:iam::123456789012:role/LaunchRole"}}}'
```
Salida:
```
{
"ConstraintDetail": {
"ConstraintId": "cons-7tr6gei4bxxxx",
"Type": "LAUNCH",
"Owner": "123456789012",
"ProductId": "prod-cfrfxmra3xxxx",
"PortfolioId": "port-y3fnkeslpxxxx"
},
"ConstraintParameters": "{\"RoleArn\" : \"arn:aws:iam::123456789012:role/LaunchRole\"}",
"Status": "CREATING"
}
```
Para obtener más información, consulte [Uso de las restricciones del AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/constraints.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [CreateConstraint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-constraint.html) en la *Referencia de comandos de la AWS CLI*.
### `create-portfolio-share`
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-id {{794123456789}}
```
Este comando no genera ningún resultado.
+ Para obtener información sobre la API, consulte [CreatePortfolioShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-portfolio-share.html) en la *Referencia de comandos de la AWS CLI*.
### `create-portfolio`
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-name {{my-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `create-product`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-product.html) en la *Referencia de comandos de la AWS CLI*.
### `create-provisioned-product-plan`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-provisioned-product-plan`.
**AWS CLI**
**Creación de un plan**
En el ejemplo de `create-provisioned-product-plan` siguiente, se crea un plan.
```
aws servicecatalog create-provisioned-product-plan \
--plan-name {{test-plan}} \
--plan-type {{CLOUDFORMATION}} \
--product-id {{prod-cfrfxmraxxxxx}} \
--provisioned-product-name {{test-pp}} \
--provisioning-artifact-id {{pa-7wz4cu5cxxxxx}}
```
Salida:
```
{
"PlanName": "test-plan",
"PlanId": "plan-cuxae3z6gxxxx",
"ProvisionProductId": "pp-7kh7wbc4xxxxx",
"ProvisionedProductName": "test-pp",
"ProvisioningArtifactId": "pa-7wz4cu5cxxxxx"
}
```
Para obtener más información, consulte [Creación de un plan de lanzamiento](https://docs.aws.amazon.com/servicecatalog/latest/userguide/launch-plan.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener detalles de la API, consulte [CreateProvisionedProductPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-provisioned-product-plan.html) en la *Referencia de comandos de la AWS CLI*.
### `create-provisioning-artifact`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-provisioning-artifact.html) en la *Referencia de comandos de la AWS CLI*.
### `create-tag-option`
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}}
--value {{name}}
```
Salida:
```
{
"TagOptionDetail": {
"Id": "tag-iabcdn4fzjjms",
"Value": "name",
"Active": true,
"Key": "1234"
}
}
```
+ Para obtener información sobre la API, consulte [CreateTagOption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/create-tag-option.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-constraint`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-constraint`.
**AWS CLI**
**Eliminación de una restricción**
En el siguiente ejemplo de `delete-constraint`, se elimina una restricción.
```
aws servicecatalog delete-constraint \
--id {{cons-7tr6gei4bxxxx}}
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Uso de las restricciones del AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/constraints.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [DeleteConstraint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-constraint.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-portfolio-share`
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-id {{123456789012}}
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [DeletePortfolioShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-portfolio-share.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-portfolio`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-product`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-product.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-provisioned-product-plan`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-provisioned-product-plan`.
**AWS CLI**
**Eliminación de un plan de productos aprovisionado**
En el ejemplo de `delete-provisioned-product-plan` siguiente, se elimina un plan de producto aprovisionado.
```
aws servicecatalog delete-provisioned-product-plan \
--plan-id {{plan-cuxae3z6gxxxx}}
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Creación de un plan de lanzamiento](https://docs.aws.amazon.com/servicecatalog/latest/userguide/launch-plan.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener detalles de la API, consulte [DeleteProvisionedProductPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-provisioned-product-plan.html) en la *Referencia de comandos de AWS CLI*.
### `delete-provisioning-artifact`
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-id {{pa-pqabcddii7ouc}}
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [DeleteProvisioningArtifact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-provisioning-artifact.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-tag-option`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/delete-tag-option.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-constraint`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-constraint`.
**AWS CLI**
**Descripción de una restricción**
En el ejemplo de `describe-constraint` siguiente, se describe una restricción.
```
aws servicecatalog describe-constraint \
--id {{"cons-oqp52evr4bxxxx"}}
```
Salida:
```
{
"ConstraintDetail": {
"ConstraintId": "cons-7tr6gei4bxxxx",
"Type": "LAUNCH",
"Owner": "123456789012",
"ProductId": "prod-cfrfxmra3xxxx",
"PortfolioId": "port-y3fnkeslpxxxx"
},
"ConstraintParameters": "{\"RoleArn\" : \"arn:aws:iam::123456789012:role/LaunchRole\"}",
"Status": "AVAILABLE"
}
```
Para obtener más información, consulte [Uso de las restricciones del AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/constraints.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [DescribeConstraint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-constraint.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-copy-product-status`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-copy-product-status.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-portfolio-share-status`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-portfolio-share-status`.
**AWS CLI**
**Descripción del estado del recurso compartido de cartera**
En el ejemplo de `describe-portfolio-share-status` siguiente, se describe el estado del recurso compartido de cartera.
```
aws servicecatalog describe-portfolio-share-status \
--portfolio-share-token {{"share-agngcybu4xxxx"}}
```
Salida:
```
{
"PortfolioShareToken": "share-agngcybu4xxxx",
"PortfolioId": "port-y3fnkeslxxxxx",
"OrganizationNodeValue": "123456789012",
"Status": "COMPLETED",
"ShareDetails": {
"SuccessfulShares": [
"012345678901"
],
"ShareErrors": []
}
}
```
Para obtener más información, consulte [Uso compartido de carteras](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_portfolios_sharing_how-to-share.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener detalles sobre la API, consulte [DescribePortfolioShareStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-portfolio-share-status.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-portfolio-shares`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-portfolio-shares`.
**AWS CLI**
**Descripción de las acciones de la cartera**
En el ejemplo de `describe-portfolio-shares` siguiente, se describen las acciones de la cartera.
```
aws servicecatalog describe-portfolio-shares \
--portfolio-id {{port-y3fnkeslxxxxx}} \
--type {{ACCOUNT}}
```
Salida:
```
{
"PortfolioShareDetails": [
{
"PrincipalId": "123456789012",
"Type": "ACCOUNT",
"Accepted": true,
"ShareTagOptions": false,
"SharePrincipals": false
},
{
"PrincipalId": "123456789012",
"Type": "ACCOUNT",
"Accepted": false,
"ShareTagOptions": false,
"SharePrincipals": false
}
]
}
```
Para obtener más información, consulte [Uso compartido de carteras](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_portfolios_sharing_how-to-share.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [DescribePortfolioShares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-portfolio-shares.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-portfolio`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-product-as-admin`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-product-as-admin.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-product`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-product`.
**AWS CLI**
**Descripción de un producto**
En el ejemplo de `describe-product` siguiente, se describe un producto.
```
aws servicecatalog describe-product \
--id {{prod-dybl43puxxxxx}}
```
Salida:
```
{
"ProductViewSummary": {
"Id": "prodview-vkvy2kum5xxxx",
"ProductId": "prod-dybl43puxxxxx",
"Name": "ec2-test",
"Owner": "user",
"ShortDescription": "",
"Type": "CLOUD_FORMATION_TEMPLATE",
"Distributor": "",
"HasDefaultPath": false,
"SupportEmail": "",
"SupportDescription": "",
"SupportUrl": ""
},
"ProvisioningArtifacts": [
{
"Id": "pa-j7fs6ybztxxxx",
"Name": "v2",
"Description": "",
"CreatedTime": "2021-07-16T15:20:24-05:00",
"Guidance": "DEFAULT"
},
{
"Id": "pa-s6z7i2nivxxxx",
"Description": "Create EC2 and KMS",
"CreatedTime": "2024-06-13T18:27:54-05:00",
"Guidance": "DEFAULT"
},
{
"Id": "pa-6573v3bloxxxx",
"Name": "v3",
"CreatedTime": "2024-06-13T18:45:14-05:00",
"Guidance": "DEFAULT"
}
],
"Budgets": [],
"LaunchPaths": [
{
"Id": "lpv3-y3fnkeslpxxxx",
"Name": "TestPort"
}
]
}
```
Para obtener más información, consulte [Administración de productos](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_products.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [DescribeProduct](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-product.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-provisioned-product-plan`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-provisioned-product-plan`.
**AWS CLI**
**Descripción de un plan de producto aprovisionado**
En el ejemplo de `describe-provisioned-product-plan` siguiente, se describe un plan de producto aprovisionado.
```
aws servicecatalog describe-provisioned-product-plan \
--plan-id {{"plan-g7iwsaf3mxxxx"}}
```
Salida:
```
{
"ProvisionedProductPlanDetails": {
"CreatedTime": "2025-11-09T18:09:37.808000-06:00",
"PathId": "lpv3-y3fnkeslpxxxx",
"ProductId": "prod-cfrfxmraxxxxx",
"PlanName": "test-plan",
"PlanId": "plan-g7iwsaf3mxxxx",
"ProvisionProductId": "pp-mkbnbztzxxxxx",
"ProvisionProductName": "test-pp",
"PlanType": "CLOUDFORMATION",
"ProvisioningArtifactId": "pa-7wz4cu5cxxxxx",
"Status": "CREATE_SUCCESS",
"UpdatedTime": "2025-11-09T18:09:46.524000-06:00",
"Tags": []
}
}
```
Para obtener más información, consulte [Creación de un plan de lanzamiento](https://docs.aws.amazon.com/servicecatalog/latest/userguide/launch-plan.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener detalles de la API, consulte [DescribeProvisionedProductPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-provisioned-product-plan.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-provisioned-product`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-provisioned-product.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-provisioning-artifact`
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-id {{prod-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-provisioning-artifact.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-provisioning-parameters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-provisioning-parameters`.
**AWS CLI**
**Descripción de los parámetros de aprovisionamiento**
En el ejemplo de `describe-provisioning-parameters` siguiente, se describen parámetros de aprovisionamiento.
```
aws servicecatalog describe-provisioning-parameters \
--product-id {{prod-cfrfxmraxxxxx}} \
--provisioning-artifact-id {{pa-7wz4cu5cxxxxx}} \
--path-id {{lpv3-y3fnkeslpxxxx}}
```
Salida:
```
{
"ProvisioningArtifactParameters": [
{
"ParameterKey": "Size",
"ParameterType": "String",
"IsNoEcho": false,
"ParameterConstraints": {
"AllowedValues": []
}
}
],
"ConstraintSummaries": [
{
"Type": "LAUNCH"
}
],
"UsageInstructions": [
{
"Type": "rules",
"Value": "{}"
},
{
"Type": "version",
"Value": "2010-09-09"
},
{
"Type": "launchAsRole",
"Value": "arn:aws:iam::123456789012:role/NewLaunchRole"
},
{
"Type": "tagUpdateOnProvisionedProduct",
"Value": "NOT_ALLOWED"
}
],
"TagOptions": [
{
"Key": "Application Name",
"Values": [
"Testing Tag",
"Testing Tag Options"
]
}
],
"ProvisioningArtifactPreferences": {},
"ProvisioningArtifactOutputs": [
{
"Key": "pa-7wz4cu5cxxxxx",
"Description": ""
}
],
"ProvisioningArtifactOutputKeys": []
}
```
Para obtener más información, consulte [Lanzamiento de un producto](https://docs.aws.amazon.com/servicecatalog/latest/userguide/enduser-launch.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener detalles sobre la API, consulte [DescribeProvisioningParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-provisioning-parameters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-tag-option`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/describe-tag-option.html) en la *Referencia de comandos de la AWS CLI*.
### `disassociate-principal-from-portfolio`
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-arn {{arn:aws:iam::123456789012:group/myendusers}}
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [DisassociatePrincipalFromPortfolio](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/disassociate-principal-from-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `disassociate-product-from-portfolio`
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-id {{port-2s6abcdq5wdh4}}
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [DisassociateProductFromPortfolio](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/disassociate-product-from-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `disassociate-tag-option-from-resource`
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 la `TagOption` especificada del recurso.
```
aws servicecatalog disassociate-tag-option-from-resource \
--resource-id {{port-2s6abcdq5wdh4}} \
--tag-option-id {{tag-p3abc2pkpz5qc}}
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [DisassociateTagOptionFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/disassociate-tag-option-from-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `list-accepted-portfolio-shares`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-accepted-portfolio-shares.html) en la *Referencia de comandos de la AWS CLI*.
### `list-constraints-for-portfolio`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-constraints-for-portfolio`.
**AWS CLI**
**Ejemplo 1: Muestra de todas las restricciones de una cartera**
En el ejemplo de `list-constraints-for-portfolio` siguiente, se muestran todas las restricciones de una cartera.
```
aws servicecatalog list-constraints-for-portfolio \
--portfolio-id {{port-y3fnkeslpxxxx}}
```
Salida:
```
{
"ConstraintDetails": [
{
"ConstraintId": "cons-dgdyqdqrxxxxx",
"Type": "LAUNCH",
"Description": "Launch as local role TestLaunchRole",
"Owner": "123456789012",
"ProductId": "prod-j6pd3hf6xxxxx",
"PortfolioId": "port-y3fnkeslxxxxx"
},
{
"ConstraintId": "cons-tzxjnj4l6xxxx",
"Type": "RESOURCE_UPDATE",
"Owner": "123456789012",
"ProductId": "prod-sphewkokxxxxx",
"PortfolioId": "port-y3fnkeslxxxxx"
}
]
}
```
**Ejemplo 2: Muestra de las restricciones de un producto**
En el ejemplo de `list-constraints-for-portfolio` siguiente, se muestran las restricciones de un producto.
```
aws servicecatalog list-constraints-for-portfolio \
--portfolio-id {{port-y3fnkeslxxxxx}} \
--product-id {{prod-j6pd3hf6xxxxx}}
```
Salida:
```
{
"ConstraintDetails": [
{
"ConstraintId": "cons-dgdyqdqrxxxxx",
"Type": "LAUNCH",
"Description": "Launch as local role TestLaunchRole",
"Owner": "123456789012",
"ProductId": "prod-j6pd3hf6xxxxx",
"PortfolioId": "port-y3fnkeslxxxxx"
}
]
}
```
Para obtener más información, consulte [Uso de las restricciones del AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/constraints.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener detalles de la API, consulte [ListConstraintsForPortfolio](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-constraints-for-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `list-launch-paths`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-launch-paths`.
**AWS CLI**
**Muestra de las rutas de lanzamiento**
En el ejemplo de `list-launch-paths` siguiente, se muestran las rutas de lanzamiento de una cartera.
```
aws servicecatalog list-launch-paths \
--product-id {{prod-cfrfxmraxxxxx}}
```
Salida:
```
{
"LaunchPathSummaries": [
{
"Id": "lpv3-y3fnkeslpxxxx",
"ConstraintSummaries": [
{
"Type": "LAUNCH"
}
],
"Tags": [],
"Name": "TestPort"
}
]
}
```
Para obtener más información, consulte [Concesión de acceso a los usuarios](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_portfolios_users.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [ListLaunchPaths](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-launch-paths.html) en la *Referencia de comandos de la AWS CLI*.
### `list-portfolio-access`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-portfolio-access.html) en la *Referencia de comandos de la AWS CLI*.
### `list-portfolios-for-product`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-portfolios-for-product.html) en la *Referencia de comandos de la AWS CLI*.
### `list-portfolios`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-portfolios.html) en la *Referencia de comandos de la AWS CLI*.
### `list-principals-for-portfolio`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-principals-for-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `list-provisioning-artifacts`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-provisioning-artifacts.html) en la *Referencia de comandos de la AWS CLI*.
### `list-resources-for-tag-option`
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 la `TagOption` 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-resources-for-tag-option.html) en la *Referencia de comandos de la AWS CLI*.
### `list-tag-options`
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 de `TagOptions`.
```
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/list-tag-options.html) en la *Referencia de comandos de la AWS CLI*.
### `provision-product`
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-id {{pa-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/provision-product.html) en la *Referencia de comandos de la AWS CLI*.
### `reject-portfolio-share`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/reject-portfolio-share.html) en la *Referencia de comandos de la AWS CLI*.
### `scan-provisioned-products`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/scan-provisioned-products.html) en la *Referencia de comandos de la AWS CLI*.
### `search-products-as-admin`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/search-products-as-admin.html) en la *Referencia de comandos de la AWS CLI*.
### `search-products`
En el siguiente ejemplo de código, se muestra cómo utilizar `search-products`.
**AWS CLI**
**Obtención de información sobre los productos a los que tiene acceso la persona que llama**
En el ejemplo de `search-products` siguiente, se muestran todos los productos a los que la persona que llama tiene acceso.
```
aws servicecatalog search-products
```
Salida:
```
{
"ProductViewSummaries": [
{
"Id": "prodview-5uksdh4xxxxxx",
"ProductId": "prod-j6fu3hxxxxxxxx",
"Name": "TestSC",
"Owner": "test",
"ShortDescription": "",
"Type": "CLOUD_FORMATION_TEMPLATE",
"Distributor": "",
"HasDefaultPath": false,
"SupportEmail": "",
"SupportDescription": "",
"SupportUrl": ""
},
{
"Id": "prodview-3kfoaabxxxxxx",
"ProductId": "prod-j6pd3xxxxxxxx",
"Name": "TestProduct",
"Owner": "test_owner",
"ShortDescription": "",
"Type": "CLOUD_FORMATION_TEMPLATE",
"Distributor": "",
"HasDefaultPath": false,
"SupportEmail": "",
"SupportDescription": "",
"SupportUrl": ""
}
]
}
```
Para obtener más información, consulte [Administración de productos](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/catalogs_products.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [SearchProducts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/search-products.html) en la *Referencia de comandos de la AWS CLI*.
### `search-provisioned-products`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/search-provisioned-products.html) en la *Referencia de comandos de la AWS CLI*.
### `terminate-provisioned-product`
En el siguiente ejemplo de código, se muestra cómo utilizar `terminate-provisioned-product`.
**AWS CLI**
**Terminación de un producto aprovisionado**
En el ejemplo de `terminate-provisioned-product` siguiente, se termina un producto aprovisionado.
```
aws servicecatalog terminate-provisioned-product \
--provisioned-product-id {{pp-7z4t3k4hxxxxx}}
```
Salida:
```
{
"RecordDetail": {
"RecordId": "rec-sbwnhzld3xxxx",
"ProvisionedProductName": "test2",
"Status": "CREATED",
"CreatedTime": "2025-12-31T15:23:55.051000-06:00",
"UpdatedTime": "2025-12-31T15:23:55.051000-06:00",
"ProvisionedProductType": "CFN_STACK",
"RecordType": "TERMINATE_PROVISIONED_PRODUCT",
"ProvisionedProductId": "pp-7z4t3k4hxxxxx",
"ProductId": "prod-j6pd3hf6xxxxx",
"ProvisioningArtifactId": "pa-sbhovlh7wxxxx",
"PathId": "lpv3-y3fnkeslpxxxx",
"RecordErrors": [],
"RecordTags": [],
"LaunchRoleArn": "arn:aws:iam::123456789012:role/TestLaunchRole"
}
}
```
Para obtener más información, consulte [Administración de productos aprovisionados](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/provisioned-products.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [TerminateProvisionedProduct](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/terminate-provisioned-product.html) en la *Referencia de comandos de la AWS CLI*.
### `update-constraint`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-constraint`.
**AWS CLI**
**Actualización de una restricción**
En el ejemplo de `update-constraint` siguiente, se actualiza una restricción.
```
aws servicecatalog update-constraint \
--id {{cons-dgdyqdqrxxxxx}} \
--parameters '{{{"LocalRoleName": "TestLaunchRole"}}}'
```
Salida:
```
{
"ConstraintDetail": {
"ConstraintId": "cons-dgdyqdqrxxxxx",
"Type": "LAUNCH",
"Description": "Launch as local role TestLaunchRole",
"Owner": "123456789012",
"ProductId": "prod-j6pd3hf6xxxxx",
"PortfolioId": "port-y3fnkeslxxxxx"
},
"ConstraintParameters": "{\"LocalRoleName\": \"TestLaunchRole\"}",
"Status": "CREATING"
}
```
Para obtener más información, consulte [Uso de las restricciones del AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/constraints.html) en la *Guía del usuario de AWS Service Catalog*.
+ Para obtener información sobre la API, consulte [UpdateConstraint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-constraint.html) en la *Referencia de comandos de la AWS CLI*.
### `update-portfolio`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-portfolio.html) en la *Referencia de comandos de la AWS CLI*.
### `update-product`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-product.html) en la *Referencia de comandos de la AWS CLI*.
### `update-provisioning-artifact`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-provisioning-artifact.html) en la *Referencia de comandos de la AWS CLI*.
### `update-tag-option`
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 valor `TagOption` 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog/update-tag-option.html) en la *Referencia de la API de la AWS CLI*.