AWS SQS 작업

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 AWS SQS 액션에 대한 참조를 제공합니다. 이러한 액션을 사용하여 Amazon SQS 대기열 및 메시지를 관리하십시오.

전제 조건

사전 요구 사항 및 자격 증명 설정에 대해서는 AWS 자격 증명 설정을 참조하십시오.

SQS 큐에 메시지를 보냅니다

작업 식별자는 aws.sqs.sendMessage입니다.

지정된 Amazon SQS 대기열로 메시지를 보냅니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 타겟 SQS 대기열의 URL입니다.	`https://sqs.us-east-2.amazonaws.com/123456789012/my-queue`
`messageBody`	문자열	필수 항목입니다. 대기열에 보낼 메시지 본문입니다.	`"This is a test message"`
`messageDeduplicationId`	문자열	선택 사항. FIFO 대기열에서 중복 제거에 사용되는 토큰입니다.	`"abc123deduplicationId5678"`
`messageGroupId`	문자열	선택 사항. FIFO 대기열의 메시지 그룹 ID입니다.	`"group1"`
`messageAttributes`	지도	선택 사항. 핵심 가치 쌍 형태의 메시지 속성입니다.	`{"my_attribute_name_1": {"DataType": "String", "StringValue": "my_attribute_value_1"}}`
`delaySeconds`	Int	선택 사항. 메시지 전달을 지연할 초 수입니다.	`123`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"statusCode": 200, "payload": {"MessageId": "e9b73a52-...", "MD5OfMessageBody": "fae535c7f..."}}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."`

산출

유형

예시

response

물체

{"statusCode": 200, "payload": {"MessageId": "e9b73a52-...", "MD5OfMessageBody": "fae535c7f..."}}

success

부울

true

또는

false

errorMessage

문자열

"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."

SQS 대기열에서 메시지를 수신합니다.

작업 식별자는 aws.sqs.receiveMessage입니다.

지정된 대기열에서 하나 이상의 메시지를 가져옵니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 타겟 SQS 대기열의 URL입니다.	`https://sqs.us-east-2.amazonaws.com/123456789012/my-queue`
`maxNumberOfMessages`	Int	선택 사항. 가져올 최대 메시지 수입니다(1～10).	`10`
`waitTimeSeconds`	Int	선택 사항. 롱 폴링을 위한 기간(초 단위)입니다.	`5`
`VisibilityTimeout`	Int	선택 사항. 수신된 메시지가 다른 소비자에게 숨겨지는 시간(초)입니다.	`123`
`AttributeNames`	목록	선택 사항. 응답에 포함할 대기열 속성 이름입니다.	`["All"]`
`messageAttributeNames`	목록	선택 사항. 가져올 메시지 속성 이름입니다.	`["message_attribute_name"]`
`messageSystemAttributeNames`	목록	선택 사항. 가져올 시스템 메시지 속성입니다.	`["SenderId", "SentTimestamp"]`
`receiveRequestAttemptId`	문자열	선택 사항. FIFO 대기열 수신 requests에 대한 중복 제거 토큰입니다.	`"req-1234abcd"`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"Messages": [{"MessageId": "...", "Body": "...", "ReceiptHandle": "..."}]}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."`

산출

유형

예시

response

물체

{"Messages": [{"MessageId": "...", "Body": "...", "ReceiptHandle": "..."}]}

success

부울

true

또는

false

errorMessage

문자열

"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."

SQS 대기열 생성

작업 식별자는 aws.sqs.createQueue입니다.

지정된 설정으로 새 Amazon SQS 대기열을 생성합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 생성될 AWS 리전입니다.	`us-east-1`
`queueName`	문자열	필수 항목입니다. 새 대기열의 이름(1～80자). 계정 및 리전 내에서 고유해야 합니다. FIFO 대기열의 경우 이름은 `.fifo` (으)로 끝나야 합니다.	`"my-app-queue"`
`attributes`	지도	선택 사항. 핵심 가치 쌍 형태의 대기열 속성. 공통 속성: `DelaySeconds` , `MessageRetentionPeriod` , `VisibilityTimeout` , `RedrivePolicy` . 숫자 값을 포함한 모든 값은 문자열이어야 합니다.	`{"DelaySeconds": "0", "MessageRetentionPeriod": "345600"}`
`tags`	지도	선택 사항. 대기열에 핵심 가치 쌍으로 할당할 태그입니다. 최대 50개의 태그입니다. `aws:` 접두사는 예약되어 있습니다.	`{"Environment": "production", "Team": "backend"}`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "queueUrl", "expression": ".response.QueueUrl"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"QueueUrl": "https://sqs.us-east-1.amazonaws.com/123456789012/my-queue"}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{"QueueUrl": "https://sqs.us-east-1.amazonaws.com/123456789012/my-queue"}

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열 삭제

작업 식별자는 aws.sqs.deleteQueue입니다.

Amazon SQS 대기열을 삭제합니다. 대기열의 모든 메시지가 영구적으로 삭제되며 이 작업은 실행 취소할 수 없습니다. 동일한 이름으로 대기열을 다시 생성하기 전에 60초의 지연 시간이 있습니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 삭제할 대기열의 URL입니다.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "status", "expression": ".success"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{}` (성공 시 비어 있음)
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{}

(성공 시 비어 있음)

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열 속성 가져오기

작업 식별자는 aws.sqs.getQueueAttributes입니다.

메시지 수, ARN, 가시성 시간 초과 및 기타 설정을 포함하여 Amazon SQS 대기열에 대한 속성을 검색합니다. 속성 이름은 대소문자를 구분합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 대기열의 URL입니다.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`attributeNames`	목록	선택 사항. 가져올 속성 이름입니다. 모든 속성을 반환하려면 `["All"]` 을(를) 사용하십시오. 기본값은 모두입니다.	`["ApproximateNumberOfMessages", "QueueArn"]`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "messageCount", "expression": ".response.Attributes.ApproximateNumberOfMessages"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"Attributes": {"QueueArn": "arn:aws:sqs:...", "ApproximateNumberOfMessages": "5", "VisibilityTimeout": "30"}}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{"Attributes": {"QueueArn": "arn:aws:sqs:...", "ApproximateNumberOfMessages": "5", "VisibilityTimeout": "30"}}

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열 속성 설정

작업 식별자는 aws.sqs.setQueueAttributes입니다.

Amazon SQS 대기열의 하나 이상의 속성을 업데이트합니다. 숫자 값을 포함하여 모든 속성 값은 문자열이어야 합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 업데이트할 대기열의 URL입니다.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`attributes`	지도	필수 항목입니다. 핵심 가치 쌍으로 설정할 대기열 속성입니다. 공통 속성: `DelaySeconds` , `MessageRetentionPeriod` , `VisibilityTimeout` , `RedrivePolicy` , `KmsMasterKeyId` . 모든 값은 문자열이어야 합니다.	`{"VisibilityTimeout": "60", "MessageRetentionPeriod": "345600"}`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "status", "expression": ".success"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{}` (성공 시 비어 있음)
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{}

(성공 시 비어 있음)

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열 비우기

작업 식별자는 aws.sqs.purgeQueue입니다.

대기열 자체를 삭제하지 않고 Amazon SQS 대기열의 모든 메시지를 삭제합니다. 이 작업은 되돌릴 수 없습니다. 제거를 완료하는 데 최대 60초가 걸릴 수 있으며, 이 기간 동안 전송된 메시지도 삭제될 수 있습니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 제거할 대기열의 URL입니다.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "status", "expression": ".success"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{}` (성공 시 비어 있음)
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{}

(성공 시 비어 있음)

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열 나열

작업 식별자는 aws.sqs.listQueues입니다.

AWS 계정의 SQS 대기열을 나열하며, 선택적으로 대기열 이름 접두사로 필터링합니다. 대기열 이름 매칭은 대소문자를 구분합니다. 기본적으로 요청당 최대 1,000개의 결과를 반환합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열을 나열할 AWS 리전입니다.	`us-east-2`
`queueNamePrefix`	문자열	선택 사항. 이름 접두사로 대기열을 필터링합니다.	`"prod-"`
`maxResults`	숫자	선택 사항. 반환할 최대 결과 수(1～1,000)입니다. 기본값은 1,000입니다.	`100`
`nextToken`	문자열	선택 사항. 결과의 다음 페이지를 가져오기 위한 이전 응답의 페이지네이션 토큰입니다.
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "queueUrls", "expression": ".response.QueueUrls // []"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"QueueUrls": ["https://sqs.us-east-1.amazonaws.com/123456789012/queue1", "..."], "NextToken": "..."}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{"QueueUrls": ["https://sqs.us-east-1.amazonaws.com/123456789012/queue1", "..."], "NextToken": "..."}

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열에서 메시지 삭제

작업 식별자는 aws.sqs.deleteMessage입니다.

수신 핸들을 사용하여 Amazon SQS 대기열에서 특정 메시지를 삭제합니다. aws.sqs.receiveMessage에서 수신 핸들을 가져옵니다. 수신 핸들은 대기열의 가시성 제한 시간이 지나면 만료됩니다. 제한 시간이 만료되면 메시지를 다시 수신하여 새 핸들을 가져오십시오.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 메시지가 포함된 대기열의 URL입니다.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`receiptHandle`	문자열	필수 항목입니다. 삭제할 메시지의 수신 핸들입니다. `aws.sqs.receiveMessage` 에서 가져옵니다.
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "status", "expression": ".success"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{}` (성공 시 비어 있음)
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{}

(성공 시 비어 있음)

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열 태그 지정

작업 식별자는 aws.sqs.tagQueue입니다.

Amazon SQS 대기열의 태그를 추가하거나 업데이트합니다. 이 작업은 기존 태그를 제거하지 않고 지정된 태그만 추가하거나 업데이트합니다. 대기열당 최대 50개의 태그를 지정할 수 있습니다. 태그 키와 값은 대소문자를 구분합니다. aws: 접두사는 예약되어 있으며 사용할 수 없습니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 태그를 지정할 대기열의 URL입니다.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`tags`	지도	필수 항목입니다. 핵심 가치 쌍으로 추가하거나 업데이트할 태그입니다.	`{"Environment": "production", "Team": "backend"}`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "status", "expression": ".success"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{}` (성공 시 비어 있음)
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{}

(성공 시 비어 있음)

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열에서 태그 제거

작업 식별자는 aws.sqs.untagQueue입니다.

Amazon SQS 대기열에서 지정된 태그를 제거합니다. 태그 키는 대소문자를 구분합니다. 존재하지 않는 키를 지정해도 오류가 발생하지 않습니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 태그를 해제할 대기열의 URL입니다.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`tagKeys`	목록	필수 항목입니다. 대기열에서 제거할 태그 키입니다.	`["TestRun", "ExpirationDate"]`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "status", "expression": ".success"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{}` (성공 시 비어 있음)
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{}

(성공 시 비어 있음)

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

SQS 대기열 태그 나열

작업 식별자는 aws.sqs.listQueueTags입니다.

Amazon SQS 대기열과 연결된 모든 태그를 나열합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 있는 AWS 리전입니다.	`us-east-2`
`queueUrl`	문자열	필수 항목입니다. 대기열의 URL입니다.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "tags", "expression": ".response.Tags"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"Tags": {"Environment": "production", "Team": "backend"}}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{"Tags": {"Environment": "production", "Team": "backend"}}

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

메시지 이동 작업을 시작합니다.

작업 식별자는 aws.sqs.startMessageMoveTask입니다.

한 대기열에서 다른 대기열로 메시지를 이동하는 작업을 시작합니다. 주요 사용 사례는 데드 레터 대기열(DLQ)에서 소스 대기열로 메시지를 복구하는 것입니다. 소스 대기열당 한 번에 하나의 활성 메시지 이동 작업만 허용됩니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 위치한 AWS 리전입니다.	`us-east-2`
`sourceArn`	문자열	필수 항목입니다. 메시지를 이동할 소스 대기열(일반적으로 DLQ)의 ARN입니다.	`arn:aws:sqs:us-east-1:123456789012:my-app-dlq`
`destinationArn`	문자열	선택 사항. 대상 대기열의 ARN입니다. 지정하지 않으면 메시지가 원래 소스 대기열로 다시 이동합니다.	`arn:aws:sqs:us-east-1:123456789012:my-app-queue`
`maxNumberOfMessagesPerSecond`	숫자	선택 사항. 초당 이동할 최대 메시지 수(1～500). 대상 대기열에 과부하가 발생하지 않도록 더 낮은 값을 사용하십시오.	`100`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "taskHandle", "expression": ".response.TaskHandle"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"TaskHandle": "AQEBIYN..."}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{"TaskHandle": "AQEBIYN..."}

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

메시지 이동 작업 나열

작업 식별자는 aws.sqs.listMessageMoveTasks입니다.

소스 대기열의 메시지 이동 작업을 나열하고 상태를 확인합니다. DLQ 복구 작업의 진행 상황을 모니터하려면 이 작업을 사용하십시오.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 소스 대기열이 위치한 AWS 리전입니다.	`us-east-2`
`sourceArn`	문자열	필수 항목입니다. 작업을 나열할 소스 대기열의 ARN입니다.	`arn:aws:sqs:us-east-1:123456789012:my-app-dlq`
`maxResults`	숫자	선택 사항. 반환할 최대 결과 수(1～10)입니다. 기본값은 10입니다.	`10`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "taskStatus", "expression": ".response.Results[0].Status"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"Results": [{"TaskHandle": "...", "Status": "RUNNING", "SourceArn": "...", "ApproximateNumberOfMessagesMoved": 42}]}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{"Results": [{"TaskHandle": "...", "Status": "RUNNING", "SourceArn": "...", "ApproximateNumberOfMessagesMoved": 42}]}

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

메시지 이동 작업을 취소합니다.

작업 식별자는 aws.sqs.cancelMessageMoveTask입니다.

실행 중인 메시지 이동 작업을 취소합니다. 취소는 즉시 이루어지지 않습니다 ― 작업 상태는 CANCELLED에 도달하기 전에 CANCELLING을(를) 거쳐 전환됩니다. 이미 이동된 메시지는 롤백되지 않습니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 대기열이 위치한 AWS 리전입니다.	`us-east-2`
`taskHandle`	문자열	필수 항목입니다. `aws.sqs.startMessageMoveTask` 에서 반환한 작업 식별자입니다. 작업이 완료되면 작업 핸들이 만료됩니다.
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "messagesMoved", "expression": ".response.ApproximateNumberOfMessagesMoved"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"ApproximateNumberOfMessagesMoved": 127}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	실패 시 오류 메시지입니다.

산출

유형

예시

response

물체

{"ApproximateNumberOfMessagesMoved": 127}

success

부울

true

또는

false

errorMessage

문자열

실패 시 오류 메시지입니다.

사용자의 편의를 위해 제공되는 기계 번역입니다.

전제 조건.css-21sua1{background:none;border:none;width:0;padding:0;}

SQS 큐에 메시지를 보냅니다

SQS 대기열에서 메시지를 수신합니다.

SQS 대기열 생성

SQS 대기열 삭제

SQS 대기열 속성 가져오기

SQS 대기열 속성 설정

SQS 대기열 비우기

SQS 대기열 나열

SQS 대기열에서 메시지 삭제

SQS 대기열 태그 지정

SQS 대기열에서 태그 제거

SQS 대기열 태그 나열

메시지 이동 작업을 시작합니다.

메시지 이동 작업 나열

메시지 이동 작업을 취소합니다.

전제 조건