Skip to main content
Astra Automation
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

후크 소스 수정

PDF

PUT /accounts/{account_id}/core/v1/hookSources/{hookSource_id}

저장된 리소스 전체를 제공된 JSON 요청 본문으로 교체하되, 사용자가 수정할 수 없는 키 값은 유지합니다.

부작용

  • 기존 소스 후크를 업데이트하면 업데이트된 소스 후크 리소스를 사용하는 일치하는 실행 후크가 있는 애플리케이션의 향후 스냅샷에 즉시 영향을 미칩니다.

  • MD5 체크섬은 "source" 필드의 값을 기반으로 계산되어 "sourceMD5Checksum" 필드의 값으로 설정됩니다.

매개변수

이름 유형 에서 필수 요소입니다 설명

account_id

문자열

경로

참

포함하는 계정 리소스의 ID

  • 예: {{.Account}}

hookSource_id

문자열

경로

참

목록에 표시할 hookSource 컬렉션의 ID

요청 본문

저장된 리소스 전체를 제공된 JSON 요청 본문으로 교체하되, 사용자가 수정할 수 없는 키 값은 유지합니다.

부작용

  • 기존 소스 후크를 업데이트하면 업데이트된 소스 후크 리소스를 사용하는 일치하는 실행 후크가 있는 애플리케이션의 향후 스냅샷에 즉시 영향을 미칩니다.

  • MD5 체크섬은 "source" 필드의 값을 기반으로 계산되어 "sourceMD5Checksum" 필드의 값으로 설정됩니다.

이름 유형 필수 요소입니다 설명

유형

문자열

참

리소스의 미디어 유형입니다. 정의된 값은 다음과 같습니다.

  • "application/astra-hookSource"

버전

문자열

참

리소스 버전입니다. 정의된 값은 다음과 같습니다.

  • "1.0"

ID입니다

문자열

거짓

리소스의 전역 고유 식별자입니다. 정의된 값은 다음과 같습니다.

  • UUIDv4 스키마를 준수합니다.

이름

문자열

거짓

사용자가 지정한 리소스 이름을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 1

  • 최대 길이: 63 이름은 모든 후크 소스 리소스 내에서 고유해야 합니다.

프라이빗

문자열

거짓

소스 필드가 API에 노출될지 아니면 의도적으로 비워질지를 나타내는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "true" - 소스 값은 비공개이며 API를 통해 노출되지 않습니다.

  • "false" - 소스 값은 비공개가 아니며 API를 통해 노출됩니다.

사전 로드됨

문자열

거짓

소스가 사전 로드되었는지 여부를 나타내는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "true" - 소스가 미리 로드되었습니다.

  • "false" - 소스가 미리 로드되지 않았습니다. 미리 로드된 후크 소스 리소스는 읽기 전용입니다.

sourceType

문자열

거짓

후크 소스 유형을 정의하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "script" - 셸 스크립트. 평문 소스에는 이진 데이터나 캐리지 리턴 문자가 포함되어서는 안 되며, 그렇지 않으면 오류가 반환됩니다.

소스

문자열

거짓

base64 형식으로 실행할 스크립트를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 0

  • 최대 길이: 131072

  • base64 인코딩 데이터 스키마를 준수합니다. base64를 사용하여 인코딩할 경우 소스 값의 최대 크기는 128KiB입니다.

sourceMD5Checksum

문자열

거짓

"source" 키 값에 대해 계산된 MD5 체크섬을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • 정의된 정규 표현식은 다음과 같습니다: "^([0-9a-fA-F]){32}$"

설명

문자열

거짓

후크 소스에 대한 사용자 지정 설명을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 0

  • 최대 길이: 511

메타데이터

"type_astra_메타데이터_업데이트"

거짓

리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.

  • Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.
요청 예시 
{
  "type": "application/astra-hookSource",
  "version": "1.0",
  "source": "ZWNobyAiVkhKaGJuTWdVbWxuYUhSeklRPT0iIHwgYmFzZTY0IC1k",
  "description": "Pre and post hook script for order processing v2"
}

응답

Status: 204, Indicates if the hookSource resource was updated.

응답

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/1",
  "title": "Resource not found",
  "detail": "The resource specified in the request URI wasn't found.",
  "status": "404"
}

정의

정의를 참조하세요

type_astra_label

이름 유형 필수 요소입니다 설명

이름

문자열

참

값

문자열

참

type_astra_메타데이터_업데이트

리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.

  • Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.

이름 유형 필수 요소입니다 설명

라벨

배열["type_astra_label"]

거짓

CreationTimestamp 를 클릭합니다

문자열

거짓

modificationTimestamp

문자열

거짓

생성 시

문자열

거짓

modifiedBy

문자열

거짓

invalidParams

이름 유형 필수 요소입니다 설명

이름

문자열

참

잘못된 쿼리 매개변수의 이름

이유

문자열

참

쿼리 매개변수가 유효하지 않은 이유

invalidFields

이름 유형 필수 요소입니다 설명

이름

문자열

참

유효하지 않은 요청 본문 필드의 이름

이유

문자열

참

요청 본문 필드가 유효하지 않은 이유