Method: projects.locations.apps.importApp

지정된 앱을 가져옵니다.

HTTP 요청

POST https://ces.googleapis.com/v1beta/{parent=projects/*/locations/*}/apps:importApp

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 가져올 앱의 위치가 포함된 상위 리소스 이름입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "displayName": string,
  "appId": string,
  "importOptions": {
    object (ImportAppRequest.ImportOptions)
  },
  "ignoreAppLock": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsUri": string,
  "appContent": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "jsonPatchContent": string,
  "jsonPatchGcsUri": string
  // End of mutually exclusive fields.
}
필드
displayName

string

(선택사항) 가져올 앱의 표시 이름입니다. * 가져오기 시 앱이 생성되고 표시 이름이 지정된 경우 가져온 앱은 이 표시 이름을 사용합니다. 기존 앱과 충돌이 감지되면 표시 이름에 타임스탬프가 추가되어 고유하게 만들어집니다. * 앱을 다시 가져온 경우 이 필드를 설정하면 안 됩니다. 다시 가져오기 중에 표시 이름을 제공하면 INVALID_ARGUMENT 오류가 발생합니다.
appId

string

(선택사항) 가져온 앱에 사용할 ID입니다. * 지정하지 않으면 앱에 고유 ID가 자동으로 할당됩니다. * 그렇지 않으면 가져온 앱이 이 ID를 리소스 이름의 마지막 구성요소로 사용합니다. ID가 동일한 앱이 프로젝트의 지정된 위치에 이미 있는 경우 기존 앱의 콘텐츠가 대체됩니다.
importOptions

object (ImportAppRequest.ImportOptions)

(선택사항) 앱의 가져오기 프로세스를 관리하는 옵션입니다.
ignoreAppLock

boolean

(선택사항) 가져오기 중에 앱 잠금을 재정의하는 플래그 true로 설정하면 가져오기 프로세스에서 앱 잠금을 무시합니다.
가져올 앱입니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
gcsUri

string

앱을 가져올 Google Cloud Storage URI입니다. 이 URI의 형식은 gs://<bucket-name>/<object-name>이어야 합니다.
appContent

string (bytes format)

앱 폴더 구조가 포함된 압축된 zip 파일을 나타내는 원시 바이트입니다.

base64 인코딩 문자열입니다.
상호 배타적 필드의 끝입니다.
가져온 앱에 적용할 JSON 패치입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
jsonPatchContent

string

(선택사항) JSON 문자열로 된 패치 콘텐츠입니다.
jsonPatchGcsUri

string

(선택사항) 패치가 포함된 JSON 파일을 가리키는 Cloud Storage URI입니다.
상호 배타적 필드의 끝입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

자세한 내용은 Authentication Overview에서 확인하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • ces.apps.import

자세한 내용은 IAM 문서를 참조하세요.

ImportAppRequest.ImportOptions

앱 가져오기 프로세스의 구성 옵션입니다. 이 옵션은 특히 기존 앱 데이터와 충돌이 발생할 때 가져오기가 작동하는 방식을 제어합니다.

JSON 표현 
{
  "conflictResolutionStrategy": enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy),
  "validateOnly": boolean
}
필드
conflictResolutionStrategy

enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy)

(선택사항) 가져오기 중에 충돌을 해결할 때 사용할 전략입니다.
validateOnly

boolean

(선택사항) 가져오기 프로세스를 시험 실행하기 위한 플래그입니다. true로 설정된 경우 가져오기 프로세스에서 검사만 실행하고 기존 앱을 변경하거나 새 앱을 만들지 않습니다.

ImportAppRequest.ImportOptions.ConflictResolutionStrategy

ID가 동일한 앱이 이미 있거나 가져온 리소스 (예: 에이전트, 도구 등)의 표시 이름이 해당 앱 내의 기존 리소스와 동일한 경우 충돌을 처리하는 전략을 정의합니다.

열거형
CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED 충돌 해결 전략이 지정되지 않았습니다.
REPLACE 기존 데이터를 가져온 데이터로 대체합니다. appId이 동일한 앱이 이미 있는 경우 가져온 앱을 기반으로 콘텐츠가 업데이트됩니다. - 가져온 앱의 리소스 (앱, 에이전트, 도구, 예시, 가드레일, 도구 모음) 중 기존 리소스와 표시 이름이 동일한 리소스는 기존 리소스를 덮어씁니다. - 새 표시 이름이 있는 가져온 리소스가 생성됩니다. - 가져온 앱에 일치하는 표시 이름이 없는 기존 리소스는 그대로 유지됩니다.
OVERWRITE 가져온 데이터로 기존 데이터를 덮어씁니다. appId이 동일한 앱이 이미 있는 경우 콘텐츠가 가져온 앱으로 덮어쓰여집니다. - 앱의 기존 리소스 (에이전트, 도구, 예시, 가드레일, 도구 세트)가 삭제됩니다. - 가져온 리소스는 새 리소스로 생성됩니다.