테이블 만들기

작업은 Create Table 스토리지 계정에 새 테이블을 만듭니다.

요청

여기에 표시된 대로 요청을 생성할 Create Table 수 있습니다. HTTPS를 사용하는 것이 좋습니다. myaccount를 스토리지 계정 이름으로 바꿉니다.

메서드	요청 URI	HTTP 버전
POST	https://myaccount.table.core.windows.net/Tables	HTTP/1.1

에뮬레이트된 스토리지 서비스 요청

에뮬레이트된 스토리지 서비스에 대해 요청하는 경우 에뮬레이터 호스트 이름 및 Azure Table Storage 포트를 로 127.0.0.1:10002지정한 다음 에뮬레이트된 스토리지 계정 이름을 지정합니다.

메서드	요청 URI	HTTP 버전
POST	http://127.0.0.1:10002/devstoreaccount1/Tables	HTTP/1.1

스토리지 에뮬레이터의 Table Service는 여러 가지 방법으로 Table Storage 서비스와 다릅니다. 자세한 내용은 스토리지 에뮬레이터와 Azure Storage 서비스 간의 차이점을 참조하세요.

URI 매개 변수

없음

요청 헤더

필수 및 선택적 요청 헤더는 다음 표에 설명되어 있습니다.

요청 헤더	Description
Authorization	필수 요소. 권한 부여 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure Storage에 대한 요청 권한 부여를 참조하세요.
Date 또는 x-ms-date	필수 요소. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage에 대한 요청 권한 부여를 참조하세요.
x-ms-version	선택 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Azure Storage 서비스에 대한 버전 관리를 참조하세요.
Content-Type	필수 요소. 페이로드의 콘텐츠 형식을 지정합니다. 가능한 값은 다음과 같습니다. - application/atom+xml (2015-12-11 이전 버전만 해당) - application/json 자세한 내용은 Table Storage 작업에 대한 페이로드 형식을 참조하세요.
Accept	선택 사항입니다. 응답 페이로드의 허용되는 콘텐츠 형식을 지정합니다. 가능한 값은 다음과 같습니다. - application/atom+xml (2015-12-11 이전 버전만 해당) - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata 자세한 내용은 Table Service 작업에 대한 페이로드 형식을 참조하세요.
Prefer	선택 사항입니다. 페이로드에 삽입된 엔터티를 응답에 포함할지 여부를 지정합니다. 가능한 값은 return-no-content 및 return-content입니다. 이 헤더에 대한 자세한 내용은 삽입 작업에서 Prefer 응답 에코를 관리하도록 헤더 설정을 참조하세요.
Content-Length	필수 요소. 요청 본문의 길이입니다.
x-ms-client-request-id	선택 사항입니다. 로깅이 구성될 때 로그에 기록되는 1키비바이트(KiB) 문자 제한을 사용하여 클라이언트에서 생성된 불투명 값을 제공합니다. 이 헤더를 사용하여 클라이언트 쪽 활동과 서버가 수신하는 요청의 상관 관계를 지정하는 것이 좋습니다. 자세한 내용은 Azure Table Storage 모니터링을 참조하세요.

요청 본문

만들 테이블의 이름을 지정하는 요청 본문입니다. 테이블 이름은 Table Storage 데이터 모델 이해에 설명된 명명 제한을 준수해야 합니다.

요청 본문은 JSON 또는 Atom 피드로 표현할 수 있는 OData 엔터티 집합입니다.

참고

JSON은 권장 페이로드 형식이며 버전 2015-12-11 이상에서 지원되는 유일한 형식입니다.

유효한 테이블 이름에 대한 지침은 Table Storage 데이터 모델 이해의 "테이블 이름" 섹션을 참조하세요.

JSON(버전 2013-08-15 이상)

JSON 피드로서의 요청 본문은 다음과 같은 일반적인 형식입니다.

{   
    "TableName":"mytable"  
}  

Atom 피드(2015-12-11 이전 버전)

Atom 피드로서의 요청 본문은 다음과 같은 일반적인 형식입니다.

<?xml version="1.0" encoding="utf-8" standalone="yes"?>     
  <entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices"   
    xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"  
    xmlns="https://www.w3.org/2005/Atom">   
    <title />   
    <updated>2009-03-18T11:48:34.9840639-07:00</updated>   
    <author>  
      <name/>   
    </author>   
      <id/>   
      <content type="application/xml">  
        <m:properties>  
          <d:TableName>mytable</d:TableName>  
        </m:properties>  
      </content>   
    </entry>  

응답

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.

상태 코드

상태 코드는 Prefer 헤더의 값에 따라 달라집니다. 헤더가 로 Prefer 설정된 return-no-content경우 성공적인 작업은 상태 코드 204(No Content)를 반환합니다. 헤더가 Prefer 지정되지 않았거나 로 설정된 return-content경우 성공적인 작업은 상태 코드 201(Created)을 반환합니다. 자세한 내용은 삽입 작업에서 Prefer 응답 에코를 관리하도록 헤더 설정을 참조하세요.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드 및Table Storage 오류 코드를 참조하세요.

응답 헤더

이 작업에 대한 응답에는 다음 표에 설명된 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더도 포함될 수 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 준수합니다.

응답 헤더	Description
x-ms-request-id	만들어진 요청을 고유하게 식별하며 이를 사용하여 요청 문제를 해결할 수 있습니다. 자세한 내용은 API 작업 문제 해결을 참조하세요.
x-ms-version	요청을 실행하는 데 사용된 Table Storage 버전을 나타냅니다. 이 헤더는 버전 2009-09-19 이상에 대해 수행되는 요청에 대해 반환됩니다.
Date	서비스에서 생성된 UTC 날짜/시간 값으로, 응답이 시작된 시간을 나타냅니다.
Preference-Applied	Prefer 요청 헤더가 적용되었는지 여부를 나타냅니다. 응답에 이 헤더가 포함되어 있지 않으면 헤더가 Prefer 적용되지 않습니다. 헤더가 반환되면 해당 값은 또는 return-no-content입니다return-content. 자세한 내용은 삽입 작업에서 Prefer 응답 에코를 관리하도록 헤더 설정을 참조하세요.
Content-Type	페이로드의 콘텐츠 형식을 나타냅니다. 값은 요청 헤더에 대해 지정된 값에 Accept 따라 달라집니다. 가능한 값은 다음과 같습니다. - application/atom+xml - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata 콘텐츠 형식에 대한 자세한 내용은 Table Storage 작업에 대한 페이로드 형식을 참조하세요.
x-ms-client-request-id	요청 및 해당 응답 문제를 해결하는 데 사용할 수 있습니다. 이 헤더의 값 x-ms-client-request-id 은 요청에 있고 값에 표시되는 ASCII 문자가 1,024자 이하인 경우 헤더 값과 같습니다. 헤더가 x-ms-client-request-id 없으면 응답에 표시되지 않습니다.

응답 본문

요청에 return-no-content 값의 Prefer 헤더가 포함된 경우 응답 본문이 반환되지 않습니다. 그렇지 않은 경우 응답 본문은 OData 엔터티 집합입니다.

참고

페이로드 형식으로 JSON을 사용하는 것이 좋습니다. 버전 2015-12-11 이상에서 지원되는 유일한 형식입니다.

JSON(버전 2013-08-15 이상)

다양한 제어 수준에 대한 JSON의 응답 페이로드는 다음과 같습니다.

전체 메타데이터

{  
  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables/@Element",  
  
    "odata.type":" myaccount.Tables",  
  
    "odata.id":"https://myaccount.table.core.windows.net/Tables('mytable')",  
  
    "odata.editLink":"Tables('mytable')",  
  
    "TableName":"mytable"  
  
}  

최소 메타데이터

{  
  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables/@Element",  
  
    "TableName":"mytable"  
  
}  
  

메타데이터 없음

{  
  
    "TableName":"mytable"  
  
}  
  

Atom 피드(2015-12-11 이전 버전)

다음은 작업에 대한 샘플 Atom 응답입니다 Create Table .

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry xml:base="https://myaccount.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="https://www.w3.org/2005/Atom"> <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>  
  <title type="text"></title>  
  <updated>2013-10-24T17:18:54.7062347Z</updated>  
  <author>  
    <name />  
  </author>  
  <link rel="edit" title="Tables" href="Tables('mytable')" />  
  <category term="myaccount.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />  
  <content type="application/xml">  
    <m:properties>  
      <d:TableName>mytable</d:TableName>  
    </m:properties>  
  </content>  
</entry>  

권한 부여

계정 소유자만 이 작업을 호출할 수 있습니다.

설명

없음

참고 항목

Azure Storage에 대한 요청 권한 부여
OData 데이터 서비스 버전 헤더 설정
상태 및 오류 코드
Table Storage 오류 코드