쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

설정
문의하기
피드백
AWS Documentation
AWS 계정 생성

Amazon Pinpoint와 함께 사용할 Postman 설정

PDF
RSS
포커스 모드
Amazon Pinpoint와 함께 사용할 Postman 설정 - Amazon Pinpoint

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

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

Amazon Pinpoint API에 액세스할 수 있는 사용자를 생성했으므로 이제 Postman을 설정할 수 있습니다. 이 단원에서는 Postman에서 하나 이상의 환경을 생성합니다. 다음에는 Amazon Pinpoint API에서 각 작업에 대한 요청 템플릿이 포함된 컬렉션을 가져옵니다.

Postman에서 워크스페이스는 프로젝트 및 환경을 위한 조직 컨테이너입니다. 이 단원에서는 Amazon Pinpoint와 함께 사용할 워크스페이스를 하나 이상 생성합니다.

워크스페이스 생성

Postman에서 추가 작업을 선택하고 파일을 선택한 다음 새로 만들기를 선택합니다.

  1. 새로 생성 창에서 워크스페이스를 선택합니다.

  2. 이름, 요약을 입력하고 표시 여부를 개인용으로 설정합니다. 그런 다음 워크스페이스 생성을 선택합니다.

Postman에서 워크스페이스는 프로젝트 및 환경을 위한 조직 컨테이너입니다. 이 단원에서는 Amazon Pinpoint와 함께 사용할 워크스페이스를 하나 이상 생성합니다.

워크스페이스 생성

Postman에서 추가 작업을 선택하고 파일을 선택한 다음 새로 만들기를 선택합니다.

  1. 새로 생성 창에서 워크스페이스를 선택합니다.

  2. 이름, 요약을 입력하고 표시 여부를 개인용으로 설정합니다. 그런 다음 워크스페이스 생성을 선택합니다.

Postman에서 환경은 키-값 페어로 저장되는 변수 세트입니다. API 요청 자체를 변경할 필요 없이, 환경을 사용하여 Postman을 통해 수행하는 요청의 구성을 변경할 수 있습니다.

이 단원에서는 Amazon Pinpoint에 사용할 환경을 최소 하나 이상 생성합니다. 생성하는 각 환경에는 단일 AWS 리전에서 계정에 특정한 변수 세트가 포함됩니다. 이 단원의 절차를 사용하여 하나 이상의 환경을 생성하면 Postman의 환경 메뉴에서 다른 환경을 선택하여 리전을 전환할 수 있습니다.

환경을 생성하는 방법

  1. Postman에서 추가 작업 메뉴를 선택하고 파일을 선택한 다음 새로 만들기를 선택합니다.

  2. 새로 생성 창에서 환경을 선택합니다.

  3. MANAGE ENVIRONMENTS 창의 환경 이름에 Amazon Pinpoint - Region Name을 입력합니다. 리전 이름을 다음 값 중 하나로 바꿉니다.

    • 미국 동부(버지니아 북부)

    • 미국 서부(오리건)

    • 아시아 태평양(뭄바이)

    • 아시아 태평양(시드니)

    • 유럽(프랑크푸르트)

    • 유럽(아일랜드)

    참고

    최소한 단일에 대해 하나의 환경만 생성하면 되며 AWS 리전,이 환경에는 하나의 프로젝트가 포함되어야 AWS 리전 합니다. 이전에 나열된 중 하나에서 프로젝트를 생성하지 않은 경우 Amazon Pinpoint 사용 설명서의 이메일 지원을 사용하여 Amazon Pinpoint 프로젝트 생성을 AWS 리전참조하세요. Amazon Pinpoint

  4. endpoint, region, serviceName, accountId, accessKey 및 secretAccessKey라는 6개의 새 변수를 생성합니다. 다음 표를 사용하여 각 변수의 초기 값 및 현재 값 열에 어떤 값을 입력해야 하는지 결정합니다.

    리전 변수 초기 값 및 현재 값
    미국 동부(버지니아 북부) endpoint pinpoint.us-east-1.amazonaws.com
    region us-east-1
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    미국 서부(오리건) endpoint pinpoint.us-west-2.amazonaws.com
    region us-west-2
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    아시아 태평양(뭄바이) endpoint pinpoint.ap-south-1.amazonaws.com
    region ap-south-1
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    아시아 태평양(시드니) endpoint pinpoint.ap-southeast-2.amazonaws.com
    region ap-southeast-2
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    유럽(프랑크푸르트) endpoint pinpoint.eu-central-1.amazonaws.com
    region eu-central-1
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    유럽(아일랜드) endpoint pinpoint.eu-west-1.amazonaws.com
    region eu-west-1
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)

    이러한 변수를 생성한 후 MANAGE ENVIRONMENTS 창은 다음 이미지에 표시된 예제와 비슷합니다.

    Postman의 환경 관리 창입니다. 이 스크린샷은 “미국 동부(버지니아 북부)라는 환경을 보여 줍니다. 이 환경에는 다음 변수가 포함되어 있습니다. 이름이 ‘endpoint’이고 초기 값이 ‘pinpoint.us-east-1.amazonaws.com‘인 변수. 이름이 ‘region’이고 초기 값이 ‘us-east-1’인 변수. 이름이 ‘serviceName’이고 초기 값이 ‘mobiletargeting’인 변수. "accountId"라는 변수와 초기 값 123456789012(가상 AWS 계정 ID). "accessKey"라는 변수와 초기 값AKIAIOSFODNN7EXAMPLE(가상 액세스 키 ID). 이름이 "secretAccessKey"이고 초기 값이 wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY(가상의 보안 액세스 키)인 변수입니다.

    마쳤으면 저장을 선택합니다.

    중요

    이전의 이미지에 표시된 액세스 키는 가상의 키입니다. IAM 액세스 키를 다른 사람과 공유하지 마세요.

    Postman에는 환경을 공유하고 내보낼 수 있는 기능이 포함되어 있습니다. 이러한 기능을 사용하는 경우 액세스 키 ID와 비밀 액세스 키를 이러한 보안 인증 정보에 액세스해서는 안 되는 사람과 공유하지 않도록 주의하세요.

    자세한 내용은 IAM 사용 설명서의 IAM 모범 사례를 참조하세요.

  5. (선택 사항) 생성하려는 각 추가 환경에 대해 1~4단계를 반복합니다.

    작은 정보

    Postman에서는 필요한 만큼 환경을 생성할 수 있습니다. 환경을 사용하는 방법은 다음과 같습니다.

    • Amazon Pinpoint API를 테스트해야 하는 모든 리전에 대해 각각 별도의 환경을 생성합니다.

    • 다른 AWS 계정과 연결되는 환경을 생성합니다.

    • 다른 사용자와 연결된 보안 인증 정보를 사용하는 환경을 생성합니다.

  6. 환경 생성을 완료하면 다음 단원으로 진행하세요.

Postman에서 환경은 키-값 페어로 저장되는 변수 세트입니다. API 요청 자체를 변경할 필요 없이, 환경을 사용하여 Postman을 통해 수행하는 요청의 구성을 변경할 수 있습니다.

이 단원에서는 Amazon Pinpoint에 사용할 환경을 최소 하나 이상 생성합니다. 생성하는 각 환경에는 단일 AWS 리전에서 계정에 특정한 변수 세트가 포함됩니다. 이 단원의 절차를 사용하여 하나 이상의 환경을 생성하면 Postman의 환경 메뉴에서 다른 환경을 선택하여 리전을 전환할 수 있습니다.

환경을 생성하는 방법

  1. Postman에서 추가 작업 메뉴를 선택하고 파일을 선택한 다음 새로 만들기를 선택합니다.

  2. 새로 생성 창에서 환경을 선택합니다.

  3. MANAGE ENVIRONMENTS 창의 환경 이름에 Amazon Pinpoint - Region Name을 입력합니다. 리전 이름을 다음 값 중 하나로 바꿉니다.

    • 미국 동부(버지니아 북부)

    • 미국 서부(오리건)

    • 아시아 태평양(뭄바이)

    • 아시아 태평양(시드니)

    • 유럽(프랑크푸르트)

    • 유럽(아일랜드)

    참고

    최소한 단일에 대해 하나의 환경만 생성하면 되며 AWS 리전,이 환경에는 하나의 프로젝트가 포함되어야 AWS 리전 합니다. 이전에 나열된 중 하나에서 프로젝트를 생성하지 않은 경우 Amazon Pinpoint 사용 설명서의 이메일 지원을 사용하여 Amazon Pinpoint 프로젝트 생성을 AWS 리전참조하세요. Amazon Pinpoint

  4. endpoint, region, serviceName, accountId, accessKey 및 secretAccessKey라는 6개의 새 변수를 생성합니다. 다음 표를 사용하여 각 변수의 초기 값 및 현재 값 열에 어떤 값을 입력해야 하는지 결정합니다.

    리전 변수 초기 값 및 현재 값
    미국 동부(버지니아 북부) endpoint pinpoint.us-east-1.amazonaws.com
    region us-east-1
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    미국 서부(오리건) endpoint pinpoint.us-west-2.amazonaws.com
    region us-west-2
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    아시아 태평양(뭄바이) endpoint pinpoint.ap-south-1.amazonaws.com
    region ap-south-1
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    아시아 태평양(시드니) endpoint pinpoint.ap-southeast-2.amazonaws.com
    region ap-southeast-2
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    유럽(프랑크푸르트) endpoint pinpoint.eu-central-1.amazonaws.com
    region eu-central-1
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)
    유럽(아일랜드) endpoint pinpoint.eu-west-1.amazonaws.com
    region eu-west-1
    serviceName mobiletargeting
    accountId ( AWS 계정 ID)
    accessKey (IAM 액세스 키 ID)
    secretAccessKey (IAM 비밀 액세스 키)

    이러한 변수를 생성한 후 MANAGE ENVIRONMENTS 창은 다음 이미지에 표시된 예제와 비슷합니다.

    Postman의 환경 관리 창입니다. 이 스크린샷은 “미국 동부(버지니아 북부)라는 환경을 보여 줍니다. 이 환경에는 다음 변수가 포함되어 있습니다. 이름이 ‘endpoint’이고 초기 값이 ‘pinpoint.us-east-1.amazonaws.com‘인 변수. 이름이 ‘region’이고 초기 값이 ‘us-east-1’인 변수. 이름이 ‘serviceName’이고 초기 값이 ‘mobiletargeting’인 변수. "accountId"라는 변수와 초기 값 123456789012(가상 AWS 계정 ID). "accessKey"라는 변수와 초기 값AKIAIOSFODNN7EXAMPLE(가상 액세스 키 ID). 이름이 "secretAccessKey"이고 초기 값이 wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY(가상의 보안 액세스 키)인 변수입니다.

    마쳤으면 저장을 선택합니다.

    중요

    이전의 이미지에 표시된 액세스 키는 가상의 키입니다. IAM 액세스 키를 다른 사람과 공유하지 마세요.

    Postman에는 환경을 공유하고 내보낼 수 있는 기능이 포함되어 있습니다. 이러한 기능을 사용하는 경우 액세스 키 ID와 비밀 액세스 키를 이러한 보안 인증 정보에 액세스해서는 안 되는 사람과 공유하지 않도록 주의하세요.

    자세한 내용은 IAM 사용 설명서의 IAM 모범 사례를 참조하세요.

  5. (선택 사항) 생성하려는 각 추가 환경에 대해 1~4단계를 반복합니다.

    작은 정보

    Postman에서는 필요한 만큼 환경을 생성할 수 있습니다. 환경을 사용하는 방법은 다음과 같습니다.

    • Amazon Pinpoint API를 테스트해야 하는 모든 리전에 대해 각각 별도의 환경을 생성합니다.

    • 다른 AWS 계정과 연결되는 환경을 생성합니다.

    • 다른 사용자와 연결된 보안 인증 정보를 사용하는 환경을 생성합니다.

  6. 환경 생성을 완료하면 다음 단원으로 진행하세요.

Postman에서 컬렉션은 API 요청 그룹입니다. 컬렉션의 요청은 일반적으로 공통적인 목적에 따라 통합됩니다. 이 단원에서는 Amazon Pinpoint API의 각 작업에 대한 요청 템플릿이 포함된 새 컬렉션을 생성합니다.

Amazon Pinpoint 컬렉션을 생성하려면

  1. Postman에서 추가 작업 메뉴를 선택하고 파일을 선택한 다음 가져오기를 선택합니다.

  2. 가져오기 창에서 링크에서 가져오기를 선택하고 https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json이라는 URL을 입력합니다.

    가져오기를 선택합니다. Postman은 120개 예제 요청이 포함된 Amazon Pinpoint 컬렉션을 가져옵니다.

Postman에서 컬렉션은 API 요청 그룹입니다. 컬렉션의 요청은 일반적으로 공통적인 목적에 따라 통합됩니다. 이 단원에서는 Amazon Pinpoint API의 각 작업에 대한 요청 템플릿이 포함된 새 컬렉션을 생성합니다.

Amazon Pinpoint 컬렉션을 생성하려면

  1. Postman에서 추가 작업 메뉴를 선택하고 파일을 선택한 다음 가져오기를 선택합니다.

  2. 가져오기 창에서 링크에서 가져오기를 선택하고 https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json이라는 URL을 입력합니다.

    가져오기를 선택합니다. Postman은 120개 예제 요청이 포함된 Amazon Pinpoint 컬렉션을 가져옵니다.

Amazon Pinpoint 컬렉션을 가져온 후 빠른 테스트를 수행하여 모든 구성 요소가 제대로 구성되어 있는지 확인하는 것이 좋습니다. GetApps 요청을 제출하여 구성을 테스트할 수 있습니다. 이 요청은 현재 AWS 리전의 Amazon Pinpoint 계정에 있는 모든 프로젝트의 목록을 반환합니다. 이 요청에는 추가 구성이 필요하므로 이 요청은 구성을 테스트하는 좋은 방법입니다.

Amazon Pinpoint 컬렉션의 구성을 테스트하려면

  1. 탐색 창에서 컬렉션을 선택하고, Amazon Pinpoint 컬렉션을 확장한 다음 Apps 폴더를 확장합니다.

  2. 요청 목록에서 GetApps를 선택합니다.

  3. 환경 선택기를 사용하여 Postman 환경 생성에서 생성한 환경을 선택합니다.

  4. 전송을 선택합니다. 요청이 성공적으로 전송되면 응답 창에 200 OK 상태가 표시됩니다. 다음 이미지의 예제와 비슷한 응답이 보입니다.

    이름, Id, Arn 및 태그에 대한 예제 가밧을 표시하는 응답입니다.
    참고

    에 생성된 프로젝트가 없는 경우 AWS 리전 Amazon Pinpoint는를 반환합니다{ "Item": [] }.

    이 응답에는 3단계에서 선택한 리전의 계정에 있는 모든 Amazon Pinpoint 프로젝트의 목록이 표시됩니다.

문제 해결

요청을 제출하면 오류를 볼 수 있습니다. 다음 목록에서 발생할 수 있는 여러 가지 일반적인 오류와 이러한 오류를 해결하기 위해 수행할 수 있는 단계를 참조하세요.

오류 메시지 문제 해결 방법

응답을 받을 수 없음

https://%7B%7Bendpoint%7D%7D/v1/apps에 연결하는 동안 오류가 발생했습니다.

{{endpoint}} 변수의 현재 값이 없습니다. 이 값은 환경을 선택할 때 설정됩니다.

환경 선택기를 사용하여 환경을 선택합니다.

요청에 포함된 보안 토큰이 잘못되었습니다.

Postman에서 액세스 키 ID 또는 보안 액세스 키의 현재 값을 찾을 수 없습니다.

환경 선택기 근처의 기어 아이콘을 선택한 다음 현재 환경을 선택합니다. accessKey 및 secretAccessKey 값이 INITIAL VALUE 및 CURRENT VALUE 열에 모두 나타나고, 보안 인증 정보를 올바르게 입력했는지 확인합니다.

"Message": "User: arn:aws:iam::123456789012:user/PinpointPostmanUser is not authorized to perform: mobiletargeting:GetApps on resource: arn:aws:mobiletargeting:us-west-2:123456789012:*"

사용자와 연결된 IAM 정책에 적절한 권한이 포함되어 있지 않습니다.

사용자가 IAM 정책 생성에서 설명한 권한을 보유하고 있고 Postman 작업 영역 생성에서 환경을 생성할 때 올바른 자격 증명을 제공했는지 확인합니다.

Amazon Pinpoint 컬렉션을 가져온 후 빠른 테스트를 수행하여 모든 구성 요소가 제대로 구성되어 있는지 확인하는 것이 좋습니다. GetApps 요청을 제출하여 구성을 테스트할 수 있습니다. 이 요청은 현재 AWS 리전의 Amazon Pinpoint 계정에 있는 모든 프로젝트의 목록을 반환합니다. 이 요청에는 추가 구성이 필요하므로 이 요청은 구성을 테스트하는 좋은 방법입니다.

Amazon Pinpoint 컬렉션의 구성을 테스트하려면

  1. 탐색 창에서 컬렉션을 선택하고, Amazon Pinpoint 컬렉션을 확장한 다음 Apps 폴더를 확장합니다.

  2. 요청 목록에서 GetApps를 선택합니다.

  3. 환경 선택기를 사용하여 Postman 환경 생성에서 생성한 환경을 선택합니다.

  4. 전송을 선택합니다. 요청이 성공적으로 전송되면 응답 창에 200 OK 상태가 표시됩니다. 다음 이미지의 예제와 비슷한 응답이 보입니다.

    이름, Id, Arn 및 태그에 대한 예제 가밧을 표시하는 응답입니다.
    참고

    에 생성된 프로젝트가 없는 경우 AWS 리전 Amazon Pinpoint는를 반환합니다{ "Item": [] }.

    이 응답에는 3단계에서 선택한 리전의 계정에 있는 모든 Amazon Pinpoint 프로젝트의 목록이 표시됩니다.

문제 해결

요청을 제출하면 오류를 볼 수 있습니다. 다음 목록에서 발생할 수 있는 여러 가지 일반적인 오류와 이러한 오류를 해결하기 위해 수행할 수 있는 단계를 참조하세요.

오류 메시지 문제 해결 방법

응답을 받을 수 없음

https://%7B%7Bendpoint%7D%7D/v1/apps에 연결하는 동안 오류가 발생했습니다.

{{endpoint}} 변수의 현재 값이 없습니다. 이 값은 환경을 선택할 때 설정됩니다.

환경 선택기를 사용하여 환경을 선택합니다.

요청에 포함된 보안 토큰이 잘못되었습니다.

Postman에서 액세스 키 ID 또는 보안 액세스 키의 현재 값을 찾을 수 없습니다.

환경 선택기 근처의 기어 아이콘을 선택한 다음 현재 환경을 선택합니다. accessKey 및 secretAccessKey 값이 INITIAL VALUE 및 CURRENT VALUE 열에 모두 나타나고, 보안 인증 정보를 올바르게 입력했는지 확인합니다.

"Message": "User: arn:aws:iam::123456789012:user/PinpointPostmanUser is not authorized to perform: mobiletargeting:GetApps on resource: arn:aws:mobiletargeting:us-west-2:123456789012:*"

사용자와 연결된 IAM 정책에 적절한 권한이 포함되어 있지 않습니다.

사용자가 IAM 정책 생성에서 설명한 권한을 보유하고 있고 Postman 작업 영역 생성에서 환경을 생성할 때 올바른 자격 증명을 제공했는지 확인합니다.

다음: 추가 요청 전송

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.