새 자격 증명 생성
POST /accounts/{account_id}/core/v1/credentials
생성할 Credential API 리소스에 대해 원하는 값을 나타냅니다.
매개변수
| 이름 | 유형 | 에서 | 필수 요소입니다 | 설명 |
|---|---|---|---|---|
account_id |
문자열 |
경로 |
참 |
포함하는 계정 리소스의 ID
|
요청 본문
생성할 Credential API 리소스에 대해 원하는 값을 나타냅니다.
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
유형 |
문자열 |
참 |
리소스의 미디어 유형입니다. 정의된 값은 다음과 같습니다.
|
버전 |
문자열 |
참 |
리소스 버전입니다. 정의된 값은 다음과 같습니다.
|
이름 |
문자열 |
참 |
사용자가 지정한 이름을 포함하는 JSON 문자열입니다. 사용자 자격 증명이 생성될 때 이름은 해당 사용자의 UUID로 설정됩니다. 정의된 값은 다음과 같습니다.
|
keyType |
문자열 |
거짓 |
keyStore의 콘텐츠에 대한 선택적 사용자 지정 데이터 유효성 검사 유형 설명자를 포함하는 JSON 문자열입니다. 확장된 업데이트 제약 조건:
|
keyStore |
참 |
JSON 문자열을 포함하는 JSON 객체입니다. keyStore의 각 문자열은 자격 증명의 일부를 나타냅니다. 각 문자열의 이름은 자격 증명 부분을 나타내며, 해당 키-값 쌍은 자격 증명의 해당 부분에 대한 값을 base64 형식으로 저장합니다. 정의된 값은 다음과 같습니다.
|
|
유효합니다 |
문자열 |
거짓 |
자격 증명의 사용 유효성을 설명하는 JSON 문자열입니다. 생략 시 기본값은 "true"입니다. 정의된 값은 다음과 같습니다.
|
validFromTimestamp |
문자열 |
거짓 |
자격 증명이 유효한 시점을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 이는 자격 증명 순환에 사용됩니다. 정의된 값은 다음과 같습니다.
|
validUntilTimestamp |
문자열 |
거짓 |
자격 증명이 더 이상 유효하지 않은 시점을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 이는 자격 증명 순환에 사용됩니다. 정의된 값은 다음과 같습니다.
|
메타데이터 |
거짓 |
리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.
|
요청 예시
{
"type": "application/astra-credential",
"version": "1.1",
"name": "myCert",
"keyStore": {
"privKey": "SGkh",
"pubKey": "VGhpcyBpcyBhbiBleGFtcGxlLg=="
}
}
응답
Status: 201, Returns the newly created credential resource in the JSON response body.
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
유형 |
문자열 |
참 |
리소스의 미디어 유형입니다. 정의된 값은 다음과 같습니다.
|
버전 |
문자열 |
참 |
리소스 버전입니다. 정의된 값은 다음과 같습니다.
|
ID입니다 |
문자열 |
참 |
리소스의 전역 고유 식별자입니다. 정의된 값은 다음과 같습니다.
|
이름 |
문자열 |
참 |
사용자가 지정한 이름을 포함하는 JSON 문자열입니다. 사용자 자격 증명이 생성될 때 이름은 해당 사용자의 UUID로 설정됩니다. 정의된 값은 다음과 같습니다.
|
keyType |
문자열 |
거짓 |
keyStore의 콘텐츠에 대한 선택적 사용자 지정 데이터 유효성 검사 유형 설명자를 포함하는 JSON 문자열입니다. 확장된 업데이트 제약 조건:
|
유효합니다 |
문자열 |
참 |
자격 증명의 사용 유효성을 설명하는 JSON 문자열입니다. 생략 시 기본값은 "true"입니다. 정의된 값은 다음과 같습니다.
|
validFromTimestamp |
문자열 |
거짓 |
자격 증명이 유효한 시점을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 이는 자격 증명 순환에 사용됩니다. 정의된 값은 다음과 같습니다.
|
validUntilTimestamp |
문자열 |
거짓 |
자격 증명이 더 이상 유효하지 않은 시점을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 이는 자격 증명 순환에 사용됩니다. 정의된 값은 다음과 같습니다.
|
메타데이터 |
참 |
리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.
|
응답 예
{
"type": "application/astra-credential",
"version": "1.1",
"id": "58e26f6a-a631-5122-8e0e-7afe306675c0",
"name": "myCert",
"valid": "true",
"metadata": {
"labels": [],
"creationTimestamp": "2022-10-06T20:58:16.305662Z",
"modificationTimestamp": "2022-10-06T20:58:16.305662Z",
"createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
}
}
응답
Status: 401, Unauthorized
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
유형 |
문자열 |
참 |
|
제목 |
문자열 |
참 |
|
세부 정보 |
문자열 |
참 |
|
상태 |
문자열 |
참 |
|
correlationID |
문자열 |
거짓 |
응답 예
{
"type": "https://astra.netapp.io/problems/3",
"title": "Missing bearer token",
"detail": "The request is missing the required bearer token.",
"status": "401"
}
응답
Status: 400, Bad request
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
유형 |
문자열 |
참 |
|
제목 |
문자열 |
참 |
|
세부 정보 |
문자열 |
참 |
|
상태 |
문자열 |
참 |
|
correlationID |
문자열 |
거짓 |
|
invalidFields |
배열["invalidFields"] |
거짓 |
유효하지 않은 요청 본문 필드 목록 |
응답 예
{
"type": "https://astra.netapp.io/problems/5",
"title": "Invalid query parameters",
"detail": "The supplied query parameters are invalid.",
"status": "400"
}
응답
Status: 409, Conflict
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
유형 |
문자열 |
참 |
|
제목 |
문자열 |
참 |
|
세부 정보 |
문자열 |
참 |
|
상태 |
문자열 |
참 |
|
correlationID |
문자열 |
거짓 |
|
invalidFields |
배열["invalidFields"] |
거짓 |
유효하지 않은 요청 본문 필드 목록 |
응답 예
{
"type": "https://astra.netapp.io/problems/10",
"title": "JSON resource conflict",
"detail": "The request body JSON contains a field that conflicts with an idempotent value.",
"status": "409"
}
응답
Status: 403, Forbidden
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
유형 |
문자열 |
참 |
|
제목 |
문자열 |
참 |
|
세부 정보 |
문자열 |
참 |
|
상태 |
문자열 |
참 |
|
correlationID |
문자열 |
거짓 |
응답 예
{
"type": "https://astra.netapp.io/problems/11",
"title": "Operation not permitted",
"detail": "The requested operation isn't permitted.",
"status": "403"
}
오류
Status: 404, Not found
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
유형 |
문자열 |
참 |
|
제목 |
문자열 |
참 |
|
세부 정보 |
문자열 |
참 |
|
상태 |
문자열 |
참 |
|
correlationID |
문자열 |
거짓 |
예시 오류 응답
{
"type": "https://astra.netapp.io/problems/2",
"title": "Collection not found",
"detail": "The collection specified in the request URI wasn't found.",
"status": "404"
}
정의
정의를 참조하세요
keyStore
JSON 문자열을 포함하는 JSON 객체입니다. keyStore의 각 문자열은 자격 증명의 일부를 나타냅니다. 각 문자열의 이름은 자격 증명 부분을 나타내며, 해당 키-값 쌍은 자격 증명의 해당 부분에 대한 값을 base64 형식으로 저장합니다. 정의된 값은 다음과 같습니다.
-
base64 인코딩 데이터 스키마를 준수하며 문자열 길이에 제한이 없습니다.
문자열을 문자열로 해시 매핑
type_astra_label
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
이름 |
문자열 |
참 |
|
값 |
문자열 |
참 |
type_astra_메타데이터_업데이트
리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.
-
Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
라벨 |
거짓 |
||
CreationTimestamp 를 클릭합니다 |
문자열 |
거짓 |
|
modificationTimestamp |
문자열 |
거짓 |
|
생성 시 |
문자열 |
거짓 |
|
modifiedBy |
문자열 |
거짓 |
invalidParams
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
이름 |
문자열 |
참 |
잘못된 쿼리 매개변수의 이름 |
이유 |
문자열 |
참 |
쿼리 매개변수가 유효하지 않은 이유 |
invalidFields
| 이름 | 유형 | 필수 요소입니다 | 설명 |
|---|---|---|---|
이름 |
문자열 |
참 |
유효하지 않은 요청 본문 필드의 이름 |
이유 |
문자열 |
참 |
요청 본문 필드가 유효하지 않은 이유 |