Contoh Service Catalog menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Service Catalog menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with Service Catalog.

Tindakan adalah kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanaccept-portfolio-share.

AWS CLI

Untuk menerima pembagian portofolio

accept-portfolio-shareContoh berikut menerima penawaran, yang dibuat oleh pengguna lain, untuk berbagi portofolio yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanassociate-principal-with-portfolio.

AWS CLI

Untuk mengasosiasikan prinsipal dengan portofolio

associate-principal-with-portfolioContoh berikut mengaitkan pengguna dengan portofolio yang ditentukan.

aws servicecatalog associate-principal-with-portfolio \
    --portfolio-id port-2s6abcdefwdh4 \
    --principal-arn arn:aws:iam::123456789012:user/usertest \
    --principal-type IAM

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanassociate-product-with-portfolio.

AWS CLI

Untuk mengaitkan produk dengan portofolio

associate-product-with-portfolioContoh berikut mengaitkan produk yang diberikan dengan portofolio yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanassociate-tag-option-with-resource.

AWS CLI

Untuk mengasosiasikan a TagOption dengan sumber daya

associate-tag-option-with-resourceContoh berikut mengaitkan yang ditentukan TagOption dengan sumber daya yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakancopy-product.

AWS CLI

Untuk menyalin produk

copy-productContoh berikut membuat salinan dari produk yang ditentukan, menggunakan JSON file untuk meneruskan parameter.

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

Isi dari copy-product-input.json:

{
    "SourceProductArn": "arn:aws:catalog:us-west-2:123456789012:product/prod-tcabcd3syn2xy",
    "TargetProductName": "copy-of-myproduct",
    "CopyOptions": [
        "CopyTags"
    ]
}

Output:

{
    "CopyProductToken": "copyproduct-abc5defgjkdji"
}

  • Untuk API detailnya, lihat CopyProductdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-portfolio-share.

AWS CLI

Untuk berbagi portofolio dengan akun

create-portfolio-shareContoh berikut berbagi portofolio yang ditentukan dengan akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakancreate-portfolio.

AWS CLI

Untuk membuat portofolio

create-portfolioContoh berikut menciptakan portofolio.

aws servicecatalog create-portfolio  \
    --provider-name my-provider \
    --display-name my-portfolio

Output:

{
    "PortfolioDetail": {
        "ProviderName": "my-provider",
        "DisplayName": "my-portfolio",
        "CreatedTime": 1571337221.555,
        "ARN": "arn:aws:catalog:us-east-2:123456789012:portfolio/port-2s6xmplq5wdh4",
        "Id": "port-2s6xmplq5wdh4"
    }
}

Contoh kode berikut menunjukkan cara menggunakancreate-product.

AWS CLI

Untuk membuat produk

create-productContoh berikut membuat produk, menggunakan JSON file untuk meneruskan parameter.

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

Isi dari create-product-input.json:

{
    "AcceptLanguage": "en",
    "Name": "test-product",
    "Owner": "test-owner",
    "Description": "test-description",
    "Distributor": "test-distributor",
    "SupportDescription": "test-support",
    "SupportEmail": "test@amazon.com",
    "SupportUrl": "https://aws.amazon.com",
    "ProductType": "CLOUD_FORMATION_TEMPLATE",
    "Tags": [
        {
            "Key": "region",
            "Value": "us-east-1"
        }
    ],
    "ProvisioningArtifactParameters": {
        "Name": "test-version-name",
        "Description": "test-version-description",
        "Info": {
            "LoadTemplateFromURL": "https://s3-us-west-1.amazonaws.com/cloudformation-templates-us-west-1/my-cfn-template.template"
        },
        "Type": "CLOUD_FORMATION_TEMPLATE"
    }
}

Output:

{
    "Tags": [
        {
            "Key": "region",
            "Value": "us-east-1"
        }
    ],
    "ProductViewDetail": {
        "CreatedTime": 1576025036.0,
        "ProductARN": "arn:aws:catalog:us-west-2:1234568542028:product/prod-3p5abcdef3oyk",
        "Status": "CREATED",
        "ProductViewSummary": {
            "Type": "CLOUD_FORMATION_TEMPLATE",
            "Distributor": "test-distributor",
            "SupportUrl": "https://aws.amazon.com",
            "SupportEmail": "test@amazon.com",
            "Id": "prodview-abcd42wvx45um",
            "SupportDescription": "test-support",
            "ShortDescription": "test-description",
            "Owner": "test-owner",
            "Name": "test-product2",
            "HasDefaultPath": false,
            "ProductId": "prod-3p5abcdef3oyk"
        }
    },
    "ProvisioningArtifactDetail": {
        "CreatedTime": 1576025036.0,
        "Active": true,
        "Id": "pa-pq3p5lil12a34",
        "Description": "test-version-description",
        "Name": "test-version-name",
        "Type": "CLOUD_FORMATION_TEMPLATE"
    }
}

  • Untuk API detailnya, lihat CreateProductdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-provisioning-artifact.

AWS CLI

Untuk membuat artefak penyediaan

create-provisioning-artifactContoh berikut membuat artefak penyediaan, menggunakan JSON file untuk meneruskan parameter.

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

Isi dari create-provisioning-artifact-input.json:

{
    "ProductId": "prod-nfi2abcdefghi",
    "Parameters": {
        "Name": "test-provisioning-artifact",
        "Description": "test description",
        "Info": {
            "LoadTemplateFromURL": "https://s3-us-west-1.amazonaws.com/cloudformation-templates-us-west-1/my-cfn-template.template"
        },
        "Type": "CLOUD_FORMATION_TEMPLATE"
    }
}

Output:

{
    "Info": {
        "TemplateUrl": "https://s3-us-west-1.amazonaws.com/cloudformation-templates-us-west-1/my-cfn-template.template"
    },
    "Status": "CREATING",
    "ProvisioningArtifactDetail": {
        "Id": "pa-bb4abcdefwnaio",
        "Name": "test-provisioning-artifact",
        "Description": "test description",
        "Active": true,
        "Type": "CLOUD_FORMATION_TEMPLATE",
        "CreatedTime": 1576022545.0
    }
}

Contoh kode berikut menunjukkan cara menggunakancreate-tag-option.

AWS CLI

Untuk membuat TagOption

create-tag-optionContoh berikut menciptakan a TagOption.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakandelete-portfolio-share.

AWS CLI

Untuk berhenti berbagi portofolio dengan akun

delete-portfolio-shareContoh berikut berhenti berbagi portofolio dengan akun yang ditentukan.

aws servicecatalog delete-portfolio-share \
    --portfolio-id port-2s6abcdq5wdh4 \
    --account-id 123456789012

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-portfolio.

AWS CLI

Untuk menghapus portofolio

delete-portfolioContoh berikut menghapus portofolio yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-product.

AWS CLI

Untuk menghapus produk

delete-productContoh berikut menghapus produk yang ditentukan.

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

Perintah ini tidak menghasilkan output.

  • Untuk API detailnya, lihat DeleteProductdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-provisioning-artifact.

AWS CLI

Untuk menghapus artefak penyediaan

delete-provisioning-artifactContoh berikut menghapus artefak penyediaan yang ditentukan.

aws servicecatalog delete-provisioning-artifact \
    --product-id prod-abc2uebuplcpw \
    --provisioning-artifact-id pa-pqabcddii7ouc

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-tag-option.

AWS CLI

Untuk menghapus TagOption

delete-tag-optionContoh berikut menghapus yang ditentukan TagOption.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandescribe-copy-product-status.

AWS CLI

Untuk menggambarkan status operasi produk salinan

describe-copy-product-statusContoh berikut menampilkan status saat ini dari operasi produk salinan asinkron yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakandescribe-portfolio.

AWS CLI

Untuk menggambarkan portofolio

describe-portfolioContoh berikut menampilkan rincian untuk portofolio yang ditentukan.

aws servicecatalog describe-portfolio \
    --id port-2s6abcdq5wdh4

Output:

{
    "TagOptions": [],
    "PortfolioDetail": {
        "ARN": "arn:aws:catalog:us-west-2:687558541234:portfolio/port-2s6abcdq5wdh4",
        "Id": "port-2s6wuzyq5wdh4",
        "CreatedTime": 1571337221.555,
        "DisplayName": "my-portfolio",
        "ProviderName": "my-provider"
    },
    "Tags": []
}

Contoh kode berikut menunjukkan cara menggunakandescribe-product-as-admin.

AWS CLI

Untuk menggambarkan suatu produk sebagai administrator

describe-product-as-adminContoh berikut menampilkan rincian untuk produk yang ditentukan menggunakan hak administrator.

aws servicecatalog describe-product-as-admin \
    --id prod-abcdcek6yhbxi

Output:

{
    "TagOptions": [],
    "ProductViewDetail": {
        "ProductARN": "arn:aws:catalog:us-west-2:687558542028:product/prod-abcdcek6yhbxi",
        "ProductViewSummary": {
            "SupportEmail": "test@amazon.com",
            "Type": "CLOUD_FORMATION_TEMPLATE",
            "Distributor": "test-distributor",
            "ShortDescription": "test-description",
            "Owner": "test-owner",
            "Id": "prodview-wi3l2j4abc6vc",
            "SupportDescription": "test-support",
            "ProductId": "prod-abcdcek6yhbxi",
            "HasDefaultPath": false,
            "Name": "test-product3",
            "SupportUrl": "https://aws.amazon.com"
        },
        "CreatedTime": 1577136715.0,
        "Status": "CREATED"
    },
    "ProvisioningArtifactSummaries": [
        {
            "CreatedTime": 1577136715.0,
            "Description": "test-version-description",
            "ProvisioningArtifactMetadata": {
                "SourceProvisioningArtifactId": "pa-abcdxkkiv5fcm"
            },
            "Name": "test-version-name-3",
            "Id": "pa-abcdxkkiv5fcm"
        }
    ],
    "Tags": [
        {
            "Value": "iad",
            "Key": "region"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakandescribe-provisioned-product.

AWS CLI

Untuk menggambarkan produk yang disediakan

describe-provisioned-productContoh berikut menampilkan rincian untuk produk yang disediakan tertentu.

aws servicecatalog describe-provisioned-product \
    --id pp-dpom27bm4abcd

Output:

{
    "ProvisionedProductDetail": {
        "Status": "ERROR",
        "CreatedTime": 1577222793.358,
        "Arn": "arn:aws:servicecatalog:us-west-2:123456789012:stack/mytestppname3/pp-dpom27bm4abcd",
        "Id": "pp-dpom27bm4abcd",
        "StatusMessage": "AmazonCloudFormationException  Parameters: [KeyName] must have values (Service: AmazonCloudFormation; Status Code: 400; Error Code: ValidationError; Request ID: 5528602a-a9ef-427c-825c-f82c31b814f5)",
        "IdempotencyToken": "527c5358-2a1a-4b9e-b1b9-7293b0ddff42",
        "LastRecordId": "rec-tfuawdjovzxge",
        "Type": "CFN_STACK",
        "Name": "mytestppname3"
    },
    "CloudWatchDashboards": []
}

Contoh kode berikut menunjukkan cara menggunakandescribe-provisioning-artifact.

AWS CLI

Untuk menggambarkan artefak penyediaan

describe-provisioning-artifactContoh berikut menampilkan rincian untuk artefak penyediaan tertentu.

aws servicecatalog describe-provisioning-artifact \
    --provisioning-artifact-id pa-pcz347abcdcfm \
    --product-id prod-abcdfz3syn2rg

Output:

{
    "Info": {
        "TemplateUrl": "https://awsdocs.s3.amazonaws.com/servicecatalog/myexampledevelopment-environment.template"
    },
    "ProvisioningArtifactDetail": {
        "Id": "pa-pcz347abcdcfm",
        "Active": true,
        "Type": "CLOUD_FORMATION_TEMPLATE",
        "Description": "updated description",
        "CreatedTime": 1562097906.0,
        "Name": "updated name"
    },
    "Status": "AVAILABLE"
}

Contoh kode berikut menunjukkan cara menggunakandescribe-tag-option.

AWS CLI

Untuk menggambarkan TagOption

describe-tag-optionContoh berikut menampilkan rincian untuk yang ditentukan TagOption.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakandisassociate-principal-from-portfolio.

AWS CLI

Untuk memisahkan kepala sekolah dari portofolio

disassociate-principal-from-portfolioContoh berikut memisahkan prinsipal yang ditentukan dari portofolio.

aws servicecatalog disassociate-principal-from-portfolio \
    --portfolio-id port-2s6abcdq5wdh4 \
    --principal-arn arn:aws:iam::123456789012:group/myendusers

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandisassociate-product-from-portfolio.

AWS CLI

Untuk memisahkan produk dari portofolio

disassociate-product-from-portfolioContoh berikut memisahkan produk yang ditentukan dari portofolio.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandisassociate-tag-option-from-resource.

AWS CLI

Untuk memisahkan a TagOption dari sumber daya

disassociate-tag-option-from-resourceContoh berikut memisahkan yang ditentukan TagOption dari sumber daya.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanlist-accepted-portfolio-shares.

AWS CLI

Untuk mencantumkan saham portofolio yang diterima

list-accepted-portfolio-sharesContoh berikut mencantumkan semua portofolio yang berbagi diterima oleh akun ini, termasuk hanya portofolio Service Catalog default.

aws servicecatalog list-accepted-portfolio-shares \
    --portfolio-share-type "AWS_SERVICECATALOG"

Output:

{
    "PortfolioDetails": [
        {
            "ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-d2abcd5dpkuma",
            "Description": "AWS Service Catalog Reference blueprints for often-used AWS services such as EC2, S3, RDS, VPC and EMR.",
            "CreatedTime": 1574456190.687,
            "ProviderName": "AWS Service Catalog",
            "DisplayName": "Reference Architectures",
            "Id": "port-d2abcd5dpkuma"
        },
        {
            "ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-abcdefaua7zpu",
            "Description": "AWS well-architected blueprints for high reliability applications.",
            "CreatedTime": 1574461496.092,
            "ProviderName": "AWS Service Catalog",
            "DisplayName": "High Reliability Architectures",
            "Id": "port-abcdefaua7zpu"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-portfolio-access.

AWS CLI

Untuk membuat daftar akun dengan akses ke portofolio

list-portfolio-accessContoh berikut mencantumkan AWS akun yang memiliki akses ke portofolio yang ditentukan.

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

Output:

{
    "AccountIds": [
        "123456789012"
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-portfolios-for-product.

AWS CLI

Untuk daftar portofolio yang terkait dengan produk

list-portfolios-for-productContoh berikut mencantumkan portofolio yang terkait dengan produk yang ditentukan.

aws servicecatalog list-portfolios-for-product \
    --product-id prod-abcdfz3syn2rg

Output:

{
    "PortfolioDetails": [
        {
            "CreatedTime": 1571337221.555,
            "Id": "port-2s6abcdq5wdh4",
            "ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-2s6abcdq5wdh4",
            "DisplayName": "my-portfolio",
            "ProviderName": "my-provider"
        },
        {
            "CreatedTime": 1559665256.348,
            "Id": "port-5abcd3e5st4ei",
            "ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-5abcd3e5st4ei",
            "DisplayName": "test",
            "ProviderName": "provider-name"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-portfolios.

AWS CLI

Untuk daftar portofolio

list-portfoliosContoh berikut mencantumkan portofolio Service Catalog di Wilayah saat ini.

aws servicecatalog list-portfolios

Output:

{
    "PortfolioDetails": [
        {
           "CreatedTime": 1559665256.348,
           "ARN": "arn:aws:catalog:us-east-2:123456789012:portfolio/port-5pzcxmplst4ei",
           "DisplayName": "my-portfolio",
           "Id": "port-5pzcxmplst4ei",
           "ProviderName": "my-user"
        }
    ]
}

  • Untuk API detailnya, lihat ListPortfoliosdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-principals-for-portfolio.

AWS CLI

Untuk daftar semua prinsipal untuk portofolio

list-principals-for-portfolioContoh berikut mencantumkan semua prinsipal untuk portofolio yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-provisioning-artifacts.

AWS CLI

Untuk mencantumkan semua artefak penyediaan untuk suatu produk

list-provisioning-artifactsContoh berikut mencantumkan semua artefak penyediaan untuk produk yang ditentukan.

aws servicecatalog list-provisioning-artifacts \
    --product-id prod-nfi2abcdefgcpw

Output:

{
    "ProvisioningArtifactDetails": [
        {
            "Id": "pa-abcdef54ipm6z",
            "Description": "test-version-description",
            "Type": "CLOUD_FORMATION_TEMPLATE",
            "CreatedTime": 1576021147.0,
            "Active": true,
            "Name": "test-version-name"
        },
        {
            "Id": "pa-bb4zyxwwnaio",
            "Description": "test description",
            "Type": "CLOUD_FORMATION_TEMPLATE",
            "CreatedTime": 1576022545.0,
            "Active": true,
            "Name": "test-provisioning-artifact-2"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-resources-for-tag-option.

AWS CLI

Untuk membuat daftar sumber daya yang terkait dengan TagOption

list-resources-for-tag-optionContoh berikut mencantumkan sumber daya yang terkait dengan yang ditentukanTagOption.

aws servicecatalog list-resources-for-tag-option \
    --tag-option-id tag-p3tej2abcd5qc

Output:

{
    "ResourceDetails": [
        {
            "ARN": "arn:aws:catalog:us-west-2:123456789012:product/prod-abcdfz3syn2rg",
            "Name": "my product",
            "Description": "description",
            "CreatedTime": 1562097906.0,
            "Id": "prod-abcdfz3syn2rg"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-tag-options.

AWS CLI

list-tag-optionsContoh berikut mencantumkan semua nilai untukTagOptions.

aws servicecatalog list-tag-options

Output:

{
    "TagOptionDetails": [
        {
            "Value": "newvalue",
            "Active": true,
            "Id": "tag-iabcdn4fzjjms",
            "Key": "1234"
        },
        {
            "Value": "value1",
            "Active": true,
            "Id": "tag-e3abcdvmwvrzy",
            "Key": "key"
        }
    ]
}

  • Untuk API detailnya, lihat ListTagOptionsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanprovision-product.

AWS CLI

Untuk menyediakan produk

provision-productContoh berikut menyediakan produk yang ditentukan menggunakan artefak penyediaan yang ditentukan.

aws servicecatalog provision-product \
    --product-id prod-abcdfz3syn2rg \
    --provisioning-artifact-id pa-abc347pcsccfm \
    --provisioned-product-name "mytestppname3"

Output:

{
    "RecordDetail": {
        "RecordId": "rec-tfuawdabcdege",
        "CreatedTime": 1577222793.362,
        "ProvisionedProductId": "pp-abcd27bm4mldq",
        "PathId": "lpv2-abcdg3jp6t5k6",
        "RecordErrors": [],
        "ProductId": "prod-abcdfz3syn2rg",
        "UpdatedTime": 1577222793.362,
        "RecordType": "PROVISION_PRODUCT",
        "ProvisionedProductName": "mytestppname3",
        "ProvisioningArtifactId": "pa-pcz347abcdcfm",
        "RecordTags": [],
        "Status": "CREATED",
        "ProvisionedProductType": "CFN_STACK"
    }
}

Contoh kode berikut menunjukkan cara menggunakanreject-portfolio-share.

AWS CLI

Untuk menolak pembagian portofolio

reject-portfolio-shareContoh berikut menolak pangsa portofolio untuk portofolio yang diberikan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanscan-provisioned-products.

AWS CLI

Untuk mencantumkan semua produk yang tersedia

scan-provisioned-productsContoh berikut mencantumkan produk yang disediakan yang tersedia.

aws servicecatalog scan-provisioned-products

Output:

{
    "ProvisionedProducts": [
        {
            "Status": "ERROR",
            "Arn": "arn:aws:servicecatalog:us-west-2:123456789012:stack/mytestppname3/pp-abcd27bm4mldq",
            "StatusMessage": "AmazonCloudFormationException  Parameters: [KeyName] must have values (Service: AmazonCloudFormation; Status Code: 400; Error Code: ValidationError; Request ID: 5528602a-a9ef-427c-825c-f82c31b814f5)",
            "Id": "pp-abcd27bm4mldq",
            "Type": "CFN_STACK",
            "IdempotencyToken": "527c5358-2a1a-4b9e-b1b9-7293b0ddff42",
            "CreatedTime": 1577222793.358,
            "Name": "mytestppname3",
            "LastRecordId": "rec-tfuawdabcdxge"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakansearch-products-as-admin.

AWS CLI

Untuk mencari produk dengan hak administrator

search-products-as-adminContoh berikut mencari produk dengan hak istimewa admin, menggunakan ID portofolio sebagai filter.

aws servicecatalog search-products-as-admin \
    --portfolio-id port-5abcd3e5st4ei

Output:

{
    "ProductViewDetails": [
        {
            "ProductViewSummary": {
                "Name": "my product",
                "Owner": "owner name",
                "Type": "CLOUD_FORMATION_TEMPLATE",
                "ProductId": "prod-abcdfz3syn2rg",
                "HasDefaultPath": false,
                "Id": "prodview-abcdmyuzv2dlu",
                "ShortDescription": "description"
            },
            "ProductARN": "arn:aws:catalog:us-west-2:123456789012:product/prod-abcdfz3syn2rg",
            "CreatedTime": 1562097906.0,
            "Status": "CREATED"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakansearch-provisioned-products.

AWS CLI

Untuk mencari produk yang disediakan

search-provisioned-productsContoh berikut mencari produk yang disediakan yang cocok dengan ID produk yang ditentukan, menggunakan JSON file untuk meneruskan parameter.

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

Isi dari search-provisioned-products-input.json:

{
    "Filters": {
        "SearchQuery": [
            "prod-tcjvfz3syn2rg"
        ]
    }
}

Output:

{
    "ProvisionedProducts": [
        {
            "ProvisioningArtifactId": "pa-pcz347abcdcfm",
            "Name": "mytestppname3",
            "CreatedTime": 1577222793.358,
            "Id": "pp-abcd27bm4mldq",
            "Status": "ERROR",
            "UserArn": "arn:aws:iam::123456789012:user/cliuser",
            "StatusMessage": "AmazonCloudFormationException  Parameters: [KeyName] must have values (Service: AmazonCloudFormation; Status Code: 400; Error Code: ValidationError; Request ID: 5528602a-a9ef-427c-825c-f82c31b814f5)",
            "Arn": "arn:aws:servicecatalog:us-west-2:123456789012:stack/mytestppname3/pp-abcd27bm4mldq",
            "Tags": [
                {
                    "Value": "arn:aws:catalog:us-west-2:123456789012:product/prod-abcdfz3syn2rg",
                    "Key": "aws:servicecatalog:productArn"
                },
                {
                    "Value": "arn:aws:iam::123456789012:user/cliuser",
                    "Key": "aws:servicecatalog:provisioningPrincipalArn"
                },
                {
                    "Value": "value-3",
                    "Key": "1234"
                },
                {
                    "Value": "pa-pcz347abcdcfm",
                    "Key": "aws:servicecatalog:provisioningArtifactIdentifier"
                },
                {
                    "Value": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-2s6abcdq5wdh4",
                    "Key": "aws:servicecatalog:portfolioArn"
                },
                {
                    "Value": "arn:aws:servicecatalog:us-west-2:123456789012:stack/mytestppname3/pp-abcd27bm4mldq",
                    "Key": "aws:servicecatalog:provisionedProductArn"
                }
            ],
            "IdempotencyToken": "527c5358-2a1a-4b9e-b1b9-7293b0ddff42",
            "UserArnSession": "arn:aws:iam::123456789012:user/cliuser",
            "Type": "CFN_STACK",
            "LastRecordId": "rec-tfuawdabcdxge",
            "ProductId": "prod-abcdfz3syn2rg"
        }
    ],
    "TotalResultsCount": 1
}

Contoh kode berikut menunjukkan cara menggunakanupdate-portfolio.

AWS CLI

Untuk memperbarui portofolio

update-portfolioContoh berikut memperbarui nama portofolio yang ditentukan.

aws servicecatalog update-portfolio \
    --id port-5abcd3e5st4ei \
    --display-name "New portfolio name"

Output:

{
    "PortfolioDetail": {
        "DisplayName": "New portfolio name",
        "ProviderName": "provider",
        "ARN": "arn:aws:catalog:us-west-2:123456789012:portfolio/port-5abcd3e5st4ei",
        "Id": "port-5abcd3e5st4ei",
        "CreatedTime": 1559665256.348
    },
    "Tags": []
}

Contoh kode berikut menunjukkan cara menggunakanupdate-product.

AWS CLI

Untuk memperbarui produk

update-productContoh berikut memperbarui nama dan pemilik produk yang ditentukan.

aws servicecatalog update-product \
    --id prod-os6abc7drqlt2 \
    --name "New product name" \
    --owner "Updated product owner"

Output:

{
    "Tags": [
        {
            "Value": "iad",
            "Key": "region"
        }
    ],
    "ProductViewDetail": {
        "ProductViewSummary": {
            "Owner": "Updated product owner",
            "ProductId": "prod-os6abc7drqlt2",
            "Distributor": "test-distributor",
            "SupportUrl": "https://aws.amazon.com",
            "Name": "New product name",
            "ShortDescription": "test-description",
            "HasDefaultPath": false,
            "Id": "prodview-6abcdgrfhvidy",
            "SupportDescription": "test-support",
            "SupportEmail": "test@amazon.com",
            "Type": "CLOUD_FORMATION_TEMPLATE"
        },
        "Status": "CREATED",
        "ProductARN": "arn:aws:catalog:us-west-2:123456789012:product/prod-os6abc7drqlt2",
        "CreatedTime": 1577136255.0
    }
}

  • Untuk API detailnya, lihat UpdateProductdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-provisioning-artifact.

AWS CLI

Untuk memperbarui artefak penyediaan

update-provisioning-artifactContoh berikut memperbarui nama dan deskripsi artefak penyediaan yang ditentukan, menggunakan JSON file untuk meneruskan parameter.

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

Isi dari update-provisioning-artifact-input.json:

{
    "ProductId": "prod-abcdfz3syn2rg",
    "ProvisioningArtifactId": "pa-pcz347abcdcfm",
    "Name": "updated name",
    "Description": "updated description"
}

Output:

{
    "Info": {
        "TemplateUrl": "https://awsdocs.s3.amazonaws.com/servicecatalog/myexampledevelopment-environment.template"
    },
    "Status": "AVAILABLE",
    "ProvisioningArtifactDetail": {
        "Active": true,
        "Description": "updated description",
        "Id": "pa-pcz347abcdcfm",
        "Name": "updated name",
        "Type": "CLOUD_FORMATION_TEMPLATE",
        "CreatedTime": 1562097906.0
    }
}

Contoh kode berikut menunjukkan cara menggunakanupdate-tag-option.

AWS CLI

Untuk memperbarui TagOption

update-tag-optionContoh berikut memperbarui nilaiTagOption, menggunakan JSON file yang ditentukan.

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

Isi dari update-tag-option-input.json:

{
    "Id": "tag-iabcdn4fzjjms",
    "Value": "newvalue",
    "Active": true
}

Output:

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