를 사용한 서비스 카탈로그 예제 AWS CLI - AWS Command Line Interface
작업

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용한 서비스 카탈로그 예제 AWS CLI

다음 코드 예제에서는 Service Catalog AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 accept-portfolio-share을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오 공유를 수락하려면

다음 accept-portfolio-share 예제에서는 지정된 포트폴리오를 공유하기 위해 다른 사용자가 한 제안을 수락합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 associate-principal-with-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

보안 주체를 포트폴리오에 연결하려면

다음 associate-principal-with-portfolio 예제에서는 사용자를 지정된 포트폴리오와 연결합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 associate-product-with-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

제품을 포트폴리오와 연결하려면

다음 associate-product-with-portfolio 예제는 지정된 제품을 지정된 포트폴리오와 연결합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 associate-tag-option-with-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

를 리소스 TagOption 와 연결하려면

다음 associate-tag-option-with-resource 예제에서는 지정된 를 지정된 리소스 TagOption 와 연결합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 copy-product을 사용하는 방법을 보여 줍니다.

AWS CLI

제품을 복사하려면

다음 copy-product 예제에서는 JSON 파일을 사용하여 파라미터를 전달하는 지정된 제품의 사본을 만듭니다.

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

copy-product-input.json의 콘텐츠:

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

출력:

{
    "CopyProductToken": "copyproduct-abc5defgjkdji"
}

  • 자세한 API 내용은 명령 참조CopyProduct의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-portfolio-share을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오를 계정과 공유하려면

다음 create-portfolio-share 예제는 지정된 포트폴리오를 지정된 계정과 공유합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 create-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오를 생성하려면

다음 create-portfolio 예제에서는 포트폴리오를 생성합니다.

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

출력:

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

  • 자세한 API 내용은 명령 참조CreatePortfolio의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-product을 사용하는 방법을 보여 줍니다.

AWS CLI

제품을 생성하려면

다음 create-product 예제에서는 JSON 파일을 사용하여 파라미터를 전달하는 제품을 생성합니다.

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

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

출력:

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

  • 자세한 API 내용은 명령 참조CreateProduct의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-provisioning-artifact을 사용하는 방법을 보여 줍니다.

AWS CLI

프로비저닝 아티팩트를 생성하려면

다음 create-provisioning-artifact 예제에서는 JSON 파일을 사용하여 파라미터를 전달하는 프로비저닝 아티팩트를 생성합니다.

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

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

출력:

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

다음 코드 예시에서는 create-tag-option을 사용하는 방법을 보여 줍니다.

AWS CLI

를 생성하려면 TagOption

다음 create-tag-option 예제에서는 를 생성합니다 TagOption.

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

출력:

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

  • 자세한 API 내용은 명령 참조CreateTagOption의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-portfolio-share을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오와 계정의 공유를 중지하려면

다음 delete-portfolio-share 예제에서는 지정된 계정과 포트폴리오 공유를 중지합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 delete-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오를 삭제하려면

다음 delete-portfolio 예제에서는 지정된 포트폴리오를 삭제합니다.

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

이 명령은 출력을 생성하지 않습니다.

  • 자세한 API 내용은 명령 참조DeletePortfolio의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-product을 사용하는 방법을 보여 줍니다.

AWS CLI

제품을 삭제하려면

다음 delete-product 예제에서는 지정된 제품을 삭제합니다.

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

이 명령은 출력을 생성하지 않습니다.

  • 자세한 API 내용은 명령 참조DeleteProduct의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-provisioning-artifact을 사용하는 방법을 보여 줍니다.

AWS CLI

프로비저닝 아티팩트를 삭제하려면

다음 delete-provisioning-artifact 예제에서는 지정된 프로비저닝 아티팩트를 삭제합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 delete-tag-option을 사용하는 방법을 보여 줍니다.

AWS CLI

를 삭제하려면 TagOption

다음 delete-tag-option 예제에서는 지정된 를 삭제합니다 TagOption.

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

이 명령은 출력을 생성하지 않습니다.

  • 자세한 API 내용은 명령 참조DeleteTagOption의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-copy-product-status을 사용하는 방법을 보여 줍니다.

AWS CLI

제품 복사 작업의 상태를 설명하려면

다음 describe-copy-product-status 예제에서는 지정된 비동기 복사 제품 작업의 현재 상태를 표시합니다.

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

출력:

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

다음 코드 예시에서는 describe-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오를 설명하려면

다음 describe-portfolio 예제에서는 지정된 포트폴리오에 대한 세부 정보를 표시합니다.

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

출력:

{
    "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": []
}

  • 자세한 API 내용은 명령 참조DescribePortfolio의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-product-as-admin을 사용하는 방법을 보여 줍니다.

AWS CLI

제품을 관리자로 설명하려면

다음 describe-product-as-admin 예제에서는 관리자 권한을 사용하여 지정된 제품에 대한 세부 정보를 표시합니다.

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

출력:

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

다음 코드 예시에서는 describe-provisioned-product을 사용하는 방법을 보여 줍니다.

AWS CLI

프로비저닝된 제품을 설명하려면

다음 describe-provisioned-product 예제에서는 지정된 프로비저닝된 제품에 대한 세부 정보를 표시합니다.

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

출력:

{
    "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": []
}

다음 코드 예시에서는 describe-provisioning-artifact을 사용하는 방법을 보여 줍니다.

AWS CLI

프로비저닝 아티팩트를 설명하려면

다음 describe-provisioning-artifact 예제에서는 지정된 프로비저닝 아티팩트에 대한 세부 정보를 표시합니다.

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

출력:

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

다음 코드 예시에서는 describe-tag-option을 사용하는 방법을 보여 줍니다.

AWS CLI

를 설명하려면 TagOption

다음 describe-tag-option 예제에서는 지정된 에 대한 세부 정보를 표시합니다 TagOption.

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

출력:

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

  • 자세한 API 내용은 명령 참조DescribeTagOption의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 disassociate-principal-from-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오에서 보안 주체 연결을 해제하려면

다음 disassociate-principal-from-portfolio 예제에서는 지정된 보안 주체를 포트폴리오에서 연결 해제합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 disassociate-product-from-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오에서 제품을 연결 해제하려면

다음 disassociate-product-from-portfolio 예제에서는 지정된 제품을 포트폴리오에서 연결 해제합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 disassociate-tag-option-from-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스 TagOption 에서 연결을 해제하려면

다음 disassociate-tag-option-from-resource 예제에서는 지정된 를 리소스TagOption에서 연결 해제합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 list-accepted-portfolio-shares을 사용하는 방법을 보여 줍니다.

AWS CLI

허용되는 포트폴리오 공유를 나열하려면

다음 list-accepted-portfolio-shares 예제에서는 기본 Service Catalog 포트폴리오만 포함하여 이 계정에서 공유를 수락한 모든 포트폴리오를 나열합니다.

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

출력:

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

다음 코드 예시에서는 list-portfolio-access을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오에 액세스할 수 있는 계정을 나열하려면

다음 list-portfolio-access 예제에서는 지정된 포트폴리오에 액세스할 수 있는 AWS 계정을 나열합니다.

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

출력:

{
    "AccountIds": [
        "123456789012"
    ]
}

  • 자세한 API 내용은 명령 참조ListPortfolioAccess의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-portfolios-for-product을 사용하는 방법을 보여 줍니다.

AWS CLI

제품과 연결된 포트폴리오를 나열하려면

다음 list-portfolios-for-product 예제에서는 지정된 제품과 연결된 포트폴리오를 나열합니다.

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

출력:

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

다음 코드 예시에서는 list-portfolios을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오를 나열하려면

다음 list-portfolios 예제에서는 현재 리전의 Service Catalog 포트폴리오를 나열합니다.

aws servicecatalog list-portfolios

출력:

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

  • 자세한 API 내용은 명령 참조ListPortfolios의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-principals-for-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오의 모든 보안 주체를 나열하려면

다음 list-principals-for-portfolio 예제에서는 지정된 포트폴리오의 모든 보안 주체를 나열합니다.

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

출력:

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

다음 코드 예시에서는 list-provisioning-artifacts을 사용하는 방법을 보여 줍니다.

AWS CLI

제품의 모든 프로비저닝 아티팩트를 나열하려면

다음 list-provisioning-artifacts 예제에서는 지정된 제품에 대한 모든 프로비저닝 아티팩트를 나열합니다.

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

출력:

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

다음 코드 예시에서는 list-resources-for-tag-option을 사용하는 방법을 보여 줍니다.

AWS CLI

에 연결된 리소스를 나열하려면 TagOption

다음 list-resources-for-tag-option 예제에서는 지정된 와 연결된 리소스를 나열합니다TagOption.

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

출력:

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

다음 코드 예시에서는 list-tag-options을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 list-tag-options 예제에서는 의 모든 값을 나열합니다TagOptions.

aws servicecatalog list-tag-options

출력:

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

  • 자세한 API 내용은 명령 참조ListTagOptions의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 provision-product을 사용하는 방법을 보여 줍니다.

AWS CLI

제품을 프로비저닝하려면

다음 provision-product 예제에서는 지정된 프로비저닝 아티팩트를 사용하여 지정된 제품을 프로비저닝합니다.

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

출력:

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

  • 자세한 API 내용은 명령 참조ProvisionProduct의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 reject-portfolio-share을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오 공유를 거부하려면

다음 reject-portfolio-share 예제에서는 지정된 포트폴리오의 포트폴리오 공유를 거부합니다.

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

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 scan-provisioned-products을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 프로비저닝된 제품을 모두 나열하려면

다음 scan-provisioned-products 예제에서는 사용 가능한 프로비저닝된 제품을 나열합니다.

aws servicecatalog scan-provisioned-products

출력:

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

다음 코드 예시에서는 search-products-as-admin을 사용하는 방법을 보여 줍니다.

AWS CLI

관리자 권한이 있는 제품을 검색하려면

다음 search-products-as-admin 예제에서는 포트폴리오 ID를 필터로 사용하여 관리자 권한이 있는 제품을 검색합니다.

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

출력:

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

다음 코드 예시에서는 search-provisioned-products을 사용하는 방법을 보여 줍니다.

AWS CLI

프로비저닝된 제품을 검색하려면

다음 search-provisioned-products 예제에서는 JSON 파일을 사용하여 파라미터를 전달하여 지정된 제품 ID와 일치하는 프로비저닝된 제품을 검색합니다.

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

search-provisioned-products-input.json의 콘텐츠:

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

출력:

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

다음 코드 예시에서는 update-portfolio을 사용하는 방법을 보여 줍니다.

AWS CLI

포트폴리오를 업데이트하려면

다음 update-portfolio 예제에서는 지정된 포트폴리오의 이름을 업데이트합니다.

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

출력:

{
    "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": []
}

  • 자세한 API 내용은 명령 참조UpdatePortfolio의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-product을 사용하는 방법을 보여 줍니다.

AWS CLI

제품을 업데이트하려면

다음 update-product 예제에서는 지정된 제품의 이름과 소유자를 업데이트합니다.

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

출력:

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

  • 자세한 API 내용은 명령 참조UpdateProduct의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-provisioning-artifact을 사용하는 방법을 보여 줍니다.

AWS CLI

프로비저닝 아티팩트를 업데이트하려면

다음 update-provisioning-artifact 예제에서는 JSON 파일을 사용하여 파라미터를 전달하여 지정된 프로비저닝 아티팩트의 이름과 설명을 업데이트합니다.

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

update-provisioning-artifact-input.json의 콘텐츠:

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

출력:

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

다음 코드 예시에서는 update-tag-option을 사용하는 방법을 보여 줍니다.

AWS CLI

를 업데이트하려면 TagOption

다음 update-tag-option 예제에서는 지정된 JSON 파일을 TagOption사용하여 의 값을 업데이트합니다.

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

update-tag-option-input.json의 콘텐츠:

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

출력:

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

  • 자세한 API 내용은 명령 참조UpdateTagOption의 섹션을 참조하세요. AWS CLI