ListTables - Amazon DynamoDB
설명요청응답특수 오류예제관련 작업

ListTables

중요

이 단원에서 언급되는 API 버전 2011-12-05는 사용 중단되었으며 새 애플리케이션에 사용해서는 안 됩니다.

현재 하위 수준 API에 대한 설명서는 Amazon DynamoDB API 참조 섹션을 참조하세요.

설명

현재 계정 및 엔드포인트에 연동되어 있는 테이블을 모두 배열 형식으로 반환합니다.

각 DynamoDB 엔드포인트는 완전히 독립적입니다. 예를 들어, dynamodb.us-west-2.amazonaws.com 및 dynamodb.us-east-1.amazonaws.com에 "MyTable"이라는 테이블이 각각 있는 경우 해당 테이블은 완전히 독립적이며 데이터를 공유하지 않습니다. ListTables 작업은 요청 계정과 연동되어 있는 테이블 이름을 비롯해 요청을 받는 엔드포인트와 연동되어 있는 테이블 이름까지 모두 반환합니다.

요청

구문

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB 하위 수준 API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.ListTables
content-type: application/x-amz-json-1.0

{"ExclusiveStartTableName":"Table1","Limit":3}

ListTables 작업은 기본적으로 요청 계정과 연동되어 있는 테이블 이름을 비롯해 요청을 받는 엔드포인트와 연동되어 있는 테이블 이름까지 모두 요청합니다.

명칭 설명 필수
Limit

반환할 수 있는 테이블 이름의 최대 수

유형: 정수

 아니요
ExclusiveStartTableName

목록에 나열되는 첫 번째 테이블 이름. 이미 앞서서 ListTables 작업을 실행하여 응답으로 LastEvaluatedTableName 값을 가져온 경우에는 여기 값을 사용하여 목록을 계속 나열하면 됩니다.

타입: 문자열

 아니요

응답

구문

HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT

{"TableNames":["Table1","Table2","Table3"], "LastEvaluatedTableName":"Table3"}
명칭 설명
TableNames

현재 엔드포인트에서 현재 계정과 연동되어 있는 테이블 이름

형식: 배열
LastEvaluatedTableName

현재 목록에서 마지막 테이블 이름. 계정 및 엔드포인트에서 일부 테이블이 반환되지 않은 경우에 한함. 이미 모든 테이블 이름이 반환된 경우에는 이 값이 응답에 표시되지 않습니다. 이 값은 모든 테이블 이름이 반환되지 않아서 목록을 계속 나열할 때 새로운 요청의 ExclusiveStartTableName으로 사용됩니다.

타입: 문자열

특수 오류

이 작업에는 특정 오류가 없습니다.

예제

다음은 ListTables 작업을 사용해 HTTP POST 요청 및 응답을 나타낸 예제입니다.

샘플 요청

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB 하위 수준 API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.ListTables
content-type: application/x-amz-json-1.0

{"ExclusiveStartTableName":"comp2","Limit":3}

샘플 응답

HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT

{"LastEvaluatedTableName":"comp5","TableNames":["comp3","comp4","comp5"]}