Ejemplos de Service Catalog que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de Service Catalog que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de AWS Command Line Interface with 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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

El siguiente ejemplo de código muestra cómo usarloaccept-portfolio-share.

AWS CLI

Para aceptar una participación en una cartera

En el siguiente accept-portfolio-share ejemplo, 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 API obtener más información, consulte AcceptPortfolioSharela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloassociate-principal-with-portfolio.

AWS CLI

Para asociar un capital a una cartera

En el siguiente associate-principal-with-portfolio ejemplo, 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.

El siguiente ejemplo de código muestra cómo usarloassociate-product-with-portfolio.

AWS CLI

Para asociar un producto a una cartera

El siguiente associate-product-with-portfolio ejemplo asocia el producto dado a la cartera especificada.

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

Este comando no genera ninguna salida.

El siguiente ejemplo de código muestra cómo usarloassociate-tag-option-with-resource.

AWS CLI

Para asociar a TagOption a un recurso

El siguiente associate-tag-option-with-resource ejemplo asocia lo especificado TagOption al recurso especificado.

aws servicecatalog associate-tag-option-with-resource \
    --resource-id port-2s6abcdq5wdh4 \
    --tag-option-id tag-p3abc2pkpz5qc

Este comando no genera ninguna salida.

El siguiente ejemplo de código muestra cómo usarlocopy-product.

AWS CLI

Para copiar un producto

En el siguiente copy-product ejemplo, se hace una copia del producto especificado mediante un JSON archivo para pasar los parámetros.

aws servicecatalog copy-product --cli-input-json file://copy-product-input.json

Contenidos 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 API obtener más información, consulte CopyProductla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-portfolio-share.

AWS CLI

Para compartir una cartera con una cuenta

En el siguiente create-portfolio-share ejemplo, se comparte la cartera especificada con la cuenta especificada.

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

Este comando no produce ningún resultado.

  • Para API obtener más información, consulte CreatePortfolioSharela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-portfolio.

AWS CLI

Para crear una cartera

En el siguiente create-portfolio ejemplo 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 API obtener más información, consulte CreatePortfoliola Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-product.

AWS CLI

Para crear un producto

En el siguiente create-product ejemplo, se crea un producto mediante un JSON archivo para pasar los parámetros.

aws servicecatalog create-product \
    --cli-input-json file://create-product-input.json

Contenidos 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 API obtener más información, consulte CreateProductla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-provisioning-artifact.

AWS CLI

Para crear un artefacto de aprovisionamiento

En el siguiente create-provisioning-artifact ejemplo, se crea un artefacto de aprovisionamiento mediante un JSON archivo para pasar los parámetros.

aws servicecatalog create-provisioning-artifact \
   --cli-input-json file://create-provisioning-artifact-input.json

Contenidos 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
    }
}

El siguiente ejemplo de código muestra cómo usarlocreate-tag-option.

AWS CLI

Para crear un TagOption

En el siguiente create-tag-option ejemplo se crea un TagOption.

aws servicecatalog create-tag-option
    --key 1234
    --value name

Salida:

{
    "TagOptionDetail": {
    "Id": "tag-iabcdn4fzjjms",
    "Value": "name",
    "Active": true,
    "Key": "1234"
    }
}

  • Para API obtener más información, consulte CreateTagOptionla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-portfolio-share.

AWS CLI

Para dejar de compartir una cartera con una cuenta

El siguiente delete-portfolio-share ejemplo 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 API obtener más información, consulte DeletePortfolioSharela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-portfolio.

AWS CLI

Para eliminar una cartera

En el siguiente delete-portfolio ejemplo, se elimina la cartera especificada.

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

Este comando no genera ninguna salida.

  • Para API obtener más información, consulte DeletePortfoliola Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-product.

AWS CLI

Para eliminar un producto

En el siguiente delete-product ejemplo, se elimina el producto especificado.

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

Este comando no genera ninguna salida.

  • Para API obtener más información, consulte DeleteProductla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-provisioning-artifact.

AWS CLI

Para eliminar un artefacto de aprovisionamiento

En el siguiente delete-provisioning-artifact ejemplo, 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.

El siguiente ejemplo de código muestra cómo usarlodelete-tag-option.

AWS CLI

Para eliminar un TagOption

En el siguiente delete-tag-option ejemplo, se elimina lo especificado TagOption.

aws servicecatalog delete-tag-option \
    --id tag-iabcdn4fzjjms

Este comando no genera ninguna salida.

  • Para API obtener más información, consulte DeleteTagOptionla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-copy-product-status.

AWS CLI

Para describir el estado de la operación de copia del producto

En el siguiente describe-copy-product-status ejemplo, 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"
}

El siguiente ejemplo de código muestra cómo usarlodescribe-portfolio.

AWS CLI

Para describir una cartera

En el siguiente describe-portfolio ejemplo, 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 API obtener más información, consulte DescribePortfoliola Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-product-as-admin.

AWS CLI

Para describir un producto como administrador

En el siguiente describe-product-as-admin ejemplo, se muestran los detalles del producto especificado con 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"
        }
    ]
}

El siguiente ejemplo de código muestra cómo usarlodescribe-provisioned-product.

AWS CLI

Para describir un producto aprovisionado

En el siguiente describe-provisioned-product ejemplo, se muestran los detalles del producto aprovisionado 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": []
}

El siguiente ejemplo de código muestra cómo usarlodescribe-provisioning-artifact.

AWS CLI

Para describir un artefacto de aprovisionamiento

En el siguiente describe-provisioning-artifact ejemplo, 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"
}

El siguiente ejemplo de código muestra cómo usarlodescribe-tag-option.

AWS CLI

Para describir un TagOption

En el siguiente describe-tag-option ejemplo, se muestran los detalles de lo especificado TagOption.

aws servicecatalog describe-tag-option \
    --id tag-p3tej2abcd5qc

Salida:

{
    "TagOptionDetail": {
        "Active": true,
        "Id": "tag-p3tej2abcd5qc",
        "Value": "value-3",
        "Key": "1234"
    }
}

  • Para API obtener más información, consulte DescribeTagOptionla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodisassociate-principal-from-portfolio.

AWS CLI

Para desasociar un capital de una cartera

El siguiente disassociate-principal-from-portfolio ejemplo disocia el capital especificado 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.

El siguiente ejemplo de código muestra cómo usarlodisassociate-product-from-portfolio.

AWS CLI

Para desasociar un producto de una cartera

El siguiente disassociate-product-from-portfolio ejemplo disocia 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.

El siguiente ejemplo de código muestra cómo usarlodisassociate-tag-option-from-resource.

AWS CLI

Para desasociar a TagOption de un recurso

En el siguiente disassociate-tag-option-from-resource ejemplo, se disocia lo especificado TagOption del recurso.

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

Este comando no genera ninguna salida.

El siguiente ejemplo de código muestra cómo usarlolist-accepted-portfolio-shares.

AWS CLI

Para enumerar las acciones de cartera aceptadas

En el siguiente list-accepted-portfolio-shares ejemplo, se enumeran todas las carteras para las 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"
        }
    ]
}

El siguiente ejemplo de código muestra cómo usarlolist-portfolio-access.

AWS CLI

Para enumerar las cuentas con acceso a una cartera

En el siguiente list-portfolio-access ejemplo, se enumeran las AWS cuentas que tienen acceso a la cartera especificada.

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

Salida:

{
    "AccountIds": [
        "123456789012"
    ]
}

  • Para API obtener más información, consulte ListPortfolioAccessla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlolist-portfolios-for-product.

AWS CLI

Para enumerar las carteras asociadas a un producto

En el siguiente list-portfolios-for-product ejemplo, se muestran las carteras asociadas al producto especificado.

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

El siguiente ejemplo de código muestra cómo usarlolist-portfolios.

AWS CLI

Para enumerar carteras

En el siguiente list-portfolios ejemplo, 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 API obtener más información, consulte ListPortfoliosla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlolist-principals-for-portfolio.

AWS CLI

Para enumerar todos los elementos principales de una cartera

En el siguiente list-principals-for-portfolio ejemplo, se enumeran todos los 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"
        }
    ]
}

El siguiente ejemplo de código muestra cómo usarlolist-provisioning-artifacts.

AWS CLI

Para enumerar todos los artefactos de aprovisionamiento de un producto

En el siguiente list-provisioning-artifacts ejemplo, se enumeran todos 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"
        }
    ]
}

El siguiente ejemplo de código muestra cómo usarlolist-resources-for-tag-option.

AWS CLI

Para enumerar los recursos asociados a un TagOption

En el siguiente list-resources-for-tag-option ejemplo, se enumeran los recursos asociados a lo especificadoTagOption.

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

El siguiente ejemplo de código muestra cómo usarlolist-tag-options.

AWS CLI

En el list-tag-options ejemplo siguiente 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 API obtener más información, consulte ListTagOptionsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloprovision-product.

AWS CLI

Para aprovisionar un producto

En el siguiente provision-product ejemplo, se aprovisiona el producto especificado mediante el artefacto de aprovisionamiento especificado.

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 API obtener más información, consulte la Referencia ProvisionProductde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloreject-portfolio-share.

AWS CLI

Para rechazar una acción de cartera

En el siguiente reject-portfolio-share ejemplo, se rechaza la parte de cartera de la cartera en cuestión.

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

Este comando no genera ninguna salida.

  • Para API obtener más información, consulte RejectPortfolioSharela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloscan-provisioned-products.

AWS CLI

Para enumerar todos los productos aprovisionados disponibles

En el siguiente scan-provisioned-products ejemplo, 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"
        }
    ]
}

El siguiente ejemplo de código muestra cómo usarlosearch-products-as-admin.

AWS CLI

Para buscar productos con privilegios de administrador

En el siguiente search-products-as-admin ejemplo, se buscan productos con privilegios de administrador utilizando un identificador 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"
        }
    ]
}

El siguiente ejemplo de código muestra cómo usarlosearch-provisioned-products.

AWS CLI

Para buscar productos aprovisionados

En el siguiente search-provisioned-products ejemplo, se buscan productos aprovisionados que coincidan con el identificador de producto especificado mediante un JSON archivo para transferir los parámetros.

aws servicecatalog search-provisioned-products \
    --cli-input-json file://search-provisioned-products-input.json

Contenidos 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
}

El siguiente ejemplo de código muestra cómo usarloupdate-portfolio.

AWS CLI

Para actualizar una cartera

En el siguiente update-portfolio ejemplo, 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 API obtener más información, consulte UpdatePortfoliola Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloupdate-product.

AWS CLI

Para actualizar un producto

En el siguiente update-product ejemplo, se actualizan el nombre y el propietario del producto especificado.

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 API obtener más información, consulte UpdateProductla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloupdate-provisioning-artifact.

AWS CLI

Para actualizar un artefacto de aprovisionamiento

En el siguiente update-provisioning-artifact ejemplo, se actualizan el nombre y la descripción del artefacto de aprovisionamiento especificado mediante un JSON archivo para transferir los parámetros.

aws servicecatalog update-provisioning-artifact \
    --cli-input-json file://update-provisioning-artifact-input.json

Contenidos 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
    }
}

El siguiente ejemplo de código muestra cómo usarloupdate-tag-option.

AWS CLI

Para actualizar un TagOption

En el siguiente update-tag-option ejemploTagOption, se actualiza el valor de a mediante el JSON archivo especificado.

aws servicecatalog update-tag-option --cli-input-json file://update-tag-option-input.json

Contenidos 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 API obtener más información, consulte UpdateTagOptionla Referencia de AWS CLI comandos.