사용자 바꾸기
전체 사용자 리소스를 바꾸려면 특정 사용자 리소스에 대해 PUT 작업을 수행합니다. 바꿀 수 있는 속성은 사용자의 ID뿐입니다. 이 바꾸기 작업을 수행해도 사용자의 권한에는 영향이 없습니다.
요청
| 메서드 | 요청 URI | 설명 |
|---|---|---|
| PUT | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name} | {databaseaccount}는 구독에서 만든 Azure Cosmos DB 계정의 이름입니다. {db-id} 값은 시스템이 생성한 ID(rid)가 아니라 사용자가 상주하는 데이터베이스의 사용자가 생성한 이름/ID입니다. {user-name} 값은 바꿀 사용자의 이름입니다. |
헤더
모든 Cosmos DB 요청에 사용되는 헤더는 일반적인 Azure Cosmos DB REST 요청 헤더를 참조하세요.
본문
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| id | 필수 | 문자열 | 사용자의 새 고유 이름을 제공합니다. |
{
"id": "another_user"
}
응답
헤더
모든 Cosmos DB 응답 에서 반환되는 헤더는 일반적인 Azure Cosmos DB REST 응답 헤더를 참조하세요.
상태 코드
다음 표에는 이 작업에서 반환하는 일반적인 상태 코드가 나열되어 있습니다. 상태 코드의 전체 목록은 HTTP 상태 코드를 참조하세요.
| HTTP 상태 코드 | Description |
|---|---|
| 200 정상 | 바꾸기 작업이 성공했습니다. |
| 400 잘못된 요청 | JSON 본문이 잘못되었습니다. 누락된 중괄호나 따옴표를 확인하세요. |
| 404 찾을 수 없음 | 교체할 사용자는 더 이상 리소스가 아닙니다. 즉, 사용자가 삭제되었습니다. |
| 409 충돌 | 사용자에게 제공된 ID는 기존 사용자가 가져온 것입니다. |
본문
| 속성 | Description |
|---|---|
| _제거 | 시스템 생성 속성입니다. 리소스 ID(_rid)는 리소스 모델의 리소스 스택에 따라 계층적인 고유 식별자입니다. 사용자 리소스의 배치와 탐색용으로 내부에서 사용됩니다. |
| _ts | 시스템 생성 속성입니다. 리소스가 마지막으로 업데이트된 시간의 타임스탬프를 지정합니다. 값은 타임스탬프입니다. |
| _self | 시스템 생성 속성입니다. 고유한 주소를 지정할 수 있는 리소스의 URI입니다. |
| _etag | 새 리소스 etag 가 생성됩니다. |
| _권한을 | 권한 리소스의 주소 지정 가능 경로를 나타내는 시스템 생성 속성입니다. |
{
"id": "another_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449604250,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000c00-0000-0000-0000-5667349a0000\"",
"_permissions": "permissions\/"
}
예제
PUT https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 19:50:50 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3d%2by3RxtfXTgRnAMx2zwCmMFx%2bbKetAvuaGmVYeS1psjE%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
Accept: application/json
Host: contosomarketing.documents.azure.com
Content-Length: 148
Expect: 100-continue
Connection: Keep-Alive
{
"id": "another_user",
}
HTTP/1.1 200 Ok
Cache-Control: no-store, no-cache
Pragma: no-cache
Content-Type: application/json
Content-Location: https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:35.212 GMT
etag: "00000c00-0000-0000-0000-5667349a0000"
x-ms-resource-quota: users=500000;
x-ms-resource-usage: users=2;
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb
x-ms-content-path: Sl8fAA==
x-ms-quorum-acked-lsn: 862
x-ms-session-token: 863
x-ms-current-write-quorum: 3
x-ms-current-replica-set-size: 4
x-ms-request-charge: 9.9
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: 8089fc55-a82c-432f-83d2-6a9ad712addd
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 19:50:51 GMT
Content-Length: 189
{
"id": "another_user",
"_rid": "Sl8fAFEKCQA=",
"_ts": 1449604250,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",
"_etag": "\"00000c00-0000-0000-0000-5667349a0000\"",
"_permissions": "permissions\/"
}