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

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

유형: Integer

아니요
ExclusiveStartTableName

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

유형: String

아니요

응답

구문

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으로 사용됩니다.

유형: String

특수 오류

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

예시

다음은 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"]}