Tools for PowerShell을 사용한 리소스 그룹 예제 - AWS SDK 코드 예제
작업

Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. AWS

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

Tools for PowerShell을 사용한 리소스 그룹 예제

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

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

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

주제

작업

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

PowerShell용 도구

예제 1:이 예제에서는 지정된 리소스 그룹 arn에 값이 'workboxes'인 태그 키 'Instances'를 추가합니다.

Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes

출력:

Arn                                                            Tags
---                                                            ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]}

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 태그를 참조하세요.

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

PowerShell용 도구

예제 1:이 예제에서는 태그 필터를 사용하여 인스턴스 리소스 유형에 대한 ResourceQuery를 생성하고 리소스를 찾습니다. 

$query = [Amazon.ResourceGroups.Model.ResourceQuery]::new()
$query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0
$query.Query = ConvertTo-Json -Compress -Depth 4 -InputObject @{
  ResourceTypeFilters = @('AWS::EC2::Instance')
  TagFilters = @(@{
    Key = 'auto'
    Values = @('no')
  })
 }

Find-RGResource -ResourceQuery $query | Select-Object -ExpandProperty ResourceIdentifiers

출력:

ResourceArn                                                     ResourceType
-----------                                                     ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 SearchResources를 참조하세요.

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

PowerShell용 도구

예제 1:이 예제는 그룹 이름에 따라 리소스 그룹을 검색합니다.

Get-RGGroup -GroupName auto-no

출력:

Description GroupArn                                                     Name
----------- --------                                                     ----
            arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 GetGroup을 참조하세요.

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

PowerShell용 도구

예제 1:이 예제에서는 이미 생성된 리소스 그룹을 나열합니다.

Get-RGGroupList

출력:

GroupArn                                                                  GroupName
--------                                                                  ---------
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no              auto-no
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes             auto-yes
arn:aws:resource-groups:eu-west-1:123456789012:group/build600             build600

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 ListGroups를 참조하세요.

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

PowerShell용 도구

예제 1:이 예제는 지정된 리소스 그룹에 대한 리소스 쿼리를 가져옵니다.

Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery

출력:

Query                                                                                        Type
-----                                                                                        ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 GetGroupQuery를 참조하세요.

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

PowerShell용 도구

예제 1:이 예제에서는 리소스 유형별로 필터링된를 기준으로 그룹 리소스를 나열합니다.

Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers

출력:

ResourceArn                                                     ResourceType
-----------                                                     ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123bc45b567890e1 AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-0a1caf2345f67d8dc AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-0fd12dd3456789012 AWS::EC2::Instance

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 ListGroupResources를 참조하세요.

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

PowerShell용 도구

예제 1:이 예제에서는 지정된 리소스 그룹 ARN에 대한 태그를 나열합니다.

Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes

출력:

Key       Value
---       -----
Instances workboxes

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 GetTags를 참조하세요.

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

PowerShell용 도구

예제 1:이 예제에서는 TestPowerShellGroup이라는 새 태그 기반 AWS Resource Groups 리소스 그룹을 생성합니다. 그룹에는 태그 키 "Name"과 태그 값 "test2"로 태그가 지정된 현재 리전의 Amazon EC2 인스턴스가 포함됩니다. 명령은 쿼리와 그룹 유형 및 작업 결과를 반환합니다.

$ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery
$ResourceQuery.Type = "TAG_FILTERS_1_0"
$ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}'
$ResourceQuery

New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group."

출력:

Query                                                                                           Type           
-----                                                                                           ----           
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0

LoggedAt         : 11/20/2018 2:40:59 PM
Group            : Amazon.ResourceGroups.Model.Group
ResourceQuery    : Amazon.ResourceGroups.Model.ResourceQuery
Tags             : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength    : 338
HttpStatusCode   : OK

  • API 세부 정보는 AWS Tools for PowerShell API 참조의 CreateGroup을 참조하세요.

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

PowerShell용 도구

예제 1:이 예제에서는 명명된 리소스 그룹을 제거합니다.

Remove-RGGroup -GroupName non-tag-cfn-elbv2

출력:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-RGGroup (DeleteGroup)" on target "non-tag-cfn-elbv2".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Description GroupArn                                                               Name
----------- --------                                                               ----
            arn:aws:resource-groups:eu-west-1:123456789012:group/non-tag-cfn-elbv2 non-tag-cfn-elbv2

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 DeleteGroup을 참조하세요.

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

PowerShell용 도구

예제 1:이 예제는 리소스 그룹에서 언급된 태그를 제거합니다.

Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances

출력:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-RGResourceTag (Untag)" on target "arn:aws:resource-groups:eu-west-1:933303704102:group/workboxes".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Arn                                                            Keys
---                                                            ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {Instances}

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 태그 해제를 참조하세요.

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

PowerShell용 도구

예제 1:이 예제에서는 그룹의 설명을 업데이트합니다.

Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove"

출력:

Description             GroupArn                                                      Name
-----------             --------                                                      ----
Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 UpdateGroup을 참조하세요.

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

PowerShell용 도구

예제 1:이 예제에서는 쿼리 객체를 생성하고 그룹에 대한 쿼리를 업데이트합니다.

$query = [Amazon.ResourceGroups.Model.ResourceQuery]::new()
$query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0
$query.Query = @{
  ResourceTypeFilters = @('AWS::EC2::Instance')
  TagFilters = @(@{
  Key='Environment'
  Values='Build600.11'
  })
} | ConvertTo-Json -Compress -Depth 4

Update-RGGroupQuery -GroupName build600 -ResourceQuery $query

출력:

GroupName ResourceQuery
--------- -------------
build600  Amazon.ResourceGroups.Model.ResourceQuery

  • API 세부 정보는 AWS Tools for PowerShell Cmdlet 참조의 UpdateGroupQuery를 참조하세요.