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

새 ASUP 리소스 생성

PDF

POST /accounts/{account_id}/core/v1/asups

생성할 ASUP API 리소스에 대해 원하는 값을 나타냅니다.

매개변수

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

account_id

문자열

경로

참

포함하는 계정 리소스의 ID

  • 예: {{.Account}}

요청 본문

생성할 ASUP API 리소스에 대해 원하는 값을 나타냅니다.

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

유형

문자열

참

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

  • "application/astra-asup"

버전

문자열

참

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

  • "1.0"

업로드

문자열

참

AutoSupport 번들 생성 성공 후 업로드 여부를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "true" - AutoSupport 번들을 업로드합니다.

  • "false" - AutoSupport 번들을 업로드하지 마십시오.

dataWindowStart

문자열

거짓

AutoSupport 번들 데이터 수집 기간의 시작 시간을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 기본값은 "dataWindowEnd" 키 값보다 24시간 전입니다. 반드시 "dataWindowEnd" 키 값 이전에 발생해야 합니다. 최대값은 요청 시점으로부터 7일 전입니다. 정의된 값은 다음과 같습니다.

  • ISO-8601 날짜/시간 스키마를 준수합니다.

dataWindowEnd

문자열

거짓

AutoSupport 번들 데이터 수집 기간의 종료 시간을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 기본값은 요청 시의 현재 시간입니다. 정의된 값은 다음과 같습니다.

  • ISO-8601 날짜/시간 스키마를 준수합니다.

메타데이터

"type_astra_메타데이터"

거짓

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

  • Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블이 없는 메타데이터 객체가 생성됩니다.
요청 예시 
{
  "type": "application/astra-asup",
  "version": "1.0",
  "upload": "true"
}

응답

Status: 201, Returns the newly created asup resource in the JSON response body.
이름 유형 필수 요소입니다 설명

유형

문자열

참

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

  • "application/astra-asup"

버전

문자열

참

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

  • "1.0"

ID입니다

문자열

참

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

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

creationState

문자열

참

AutoSupport 번들의 생성 상태를 나타내는 값을 포함하는 JSON 문자열입니다. "completed" 및 "partial" 상태의 경우, Accept 헤더에 "/" 또는 "application/gzip"이 포함된 리소스 URI에 대한 GET 요청을 수행하여 번들을 다운로드할 수 있습니다. 정의된 값은 다음과 같습니다.

  • "실행 중" - AutoSupport 번들 생성이 정상적으로 실행되고 있습니다.

  • "완료됨" - AutoSupport 번들 생성이 완료되었습니다.

  • "partial" - AutoSupport 번들 생성이 완료되었지만 일부 데이터가 번들에 포함되지 않았습니다.

  • "failed" - AutoSupport 번들 생성이 영구적인 실패 상태입니다.

creationStateDetails

배열["type_astra_stateDetail"]

참

"creationState"가 "partial" 또는 "failed"로 전환된 이유에 대한 추가 정보를 나열하는 JSON 객체의 JSON 배열입니다. 정보가 없는 경우 이 배열은 비어 있습니다.

  • 최소 항목: 0

업로드

문자열

참

AutoSupport 번들 생성 성공 후 업로드 여부를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "true" - AutoSupport 번들을 업로드합니다.

  • "false" - AutoSupport 번들을 업로드하지 마십시오.

uploadState

문자열

거짓

요청된 경우 AutoSupport 번들 업로드 상태를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "pending" - AutoSupport 번들 업로드는 AutoSupport 번들 생성이 완료될 때("creationState"가 "running") 예약됩니다.

  • "blocked" - AutoSupport 번들 업로드가 시도되지 않았습니다. 번들이 생성되지 않았거나("creationState"가 "failed") 라이선스가 없어서 업로드가 차단되었습니다.

  • "running" - AutoSupport 번들 업로드가 정상적으로 실행 중입니다("creationState"가 "completed" 또는 "partial"인 경우).

  • "완료됨" - AutoSupport 번들 업로드가 완료되었습니다.

  • "failed" - AutoSupport 번들 업로드가 영구적인 실패 상태입니다.

uploadStateDetails

배열["type_astra_stateDetail"]

거짓

"uploadState"가 "failed"로 전환된 이유에 대한 추가 세부 정보를 나열하는 JSON 객체의 JSON 배열입니다. 사용 가능한 세부 정보가 없는 경우 이 배열은 비어 있습니다.

  • 최소 항목: 0

triggerType

문자열

참

ASUP 리소스 생성을 촉발한 요인을 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "manual" - ASUP 리소스 및 관련 AutoSupport 번들은 수동으로 생성되었습니다.

  • "scheduled" - ASUP 리소스와 관련 AutoSupport 번들은 구성된 일정에 따라 생성되었습니다.

dataWindowStart

문자열

참

AutoSupport 번들 데이터 수집 기간의 시작 시간을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 기본값은 "dataWindowEnd" 키 값보다 24시간 전입니다. 반드시 "dataWindowEnd" 키 값 이전에 발생해야 합니다. 최대값은 요청 시점으로부터 7일 전입니다. 정의된 값은 다음과 같습니다.

  • ISO-8601 날짜/시간 스키마를 준수합니다.

dataWindowEnd

문자열

참

AutoSupport 번들 데이터 수집 기간의 종료 시간을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 기본값은 요청 시의 현재 시간입니다. 정의된 값은 다음과 같습니다.

  • ISO-8601 날짜/시간 스키마를 준수합니다.

메타데이터

"type_astra_메타데이터"

참

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

  • Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블이 없는 메타데이터 객체가 생성됩니다.
응답 예 
{
  "type": "application/astra-asup",
  "version": "1.0",
  "id": "9950003f-a1c7-5ca7-8930-06eec25f60aa",
  "creationState": "running",
  "creationStateDetails": [],
  "upload": "true",
  "uploadState": "pending",
  "uploadStateDetails": [],
  "triggerType": "manual",
  "dataWindowStart": "2020-08-05T12:24:00.000000Z",
  "dataWindowEnd": "2020-08-06T12:24:52.000000Z",
  "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"
}

정의

정의를 참조하세요

type_astra_label

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

이름

문자열

참

값

문자열

참

type_astra_메타데이터

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

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

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

라벨

배열["type_astra_label"]

참

CreationTimestamp 를 클릭합니다

문자열

참

modificationTimestamp

문자열

참

생성 시

문자열

참

modifiedBy

문자열

거짓

additionalDetails

type_astra_stateDetail

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

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

additionalDetails

"additionalDetails"

거짓

invalidParams

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

이름

문자열

참

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

이유

문자열

참

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

invalidFields

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

이름

문자열

참

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

이유

문자열

참

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