프로젝트 API 변경 로그
이 변경 로그에서 프로젝트 API 의 최신 변경사항, 개선사항 및 업데이트에 대해 학습할 수 있습니다. 변경 로그에는 변경사항이 릴리스 날짜별로 정렬되어 있습니다. 기존 API 버전에 대한 변경사항은 기존 클라이언트 애플리케이션과 호환되도록 설계되었습니다.
2024년 4월 3 일
이제 프로젝트 API v1.0.0 을 사용할 수 있습니다. 베타에서 버전을 업데이트해야 합니다.
다음 변경사항은 list 조작의 페이지 매김에 영향을 줍니다. 자세한 정보는 프로젝트 API 문서의 페이지 매김 섹션을 참조하십시오.
목록 프로젝트
GET /v1/projects
- 페이지 토큰 조회 매개변수의 이름이
start에서token(으) 로 바뀌었습니다.- 예를 들어,
list-projects오퍼레이션을 호출하면GET /v1/projects?limit=5&start={page_token}에서GET /v1/projects?limit=5&token={page_token}로 변경됩니다.
- 예를 들어,
- 첫 번째 페이지는 요청 URL에서 토큰 조회 매개변수 없이 리턴됩니다. 예를 들어,
GET /v1/projects?limit=5또는GET /v1/projects입니다.- 지정된 페이지 토큰이 올바르지 않은 경우에도 첫 번째 페이지가 리턴됩니다.
last및previous필드는 더 이상 지원되지 않으며 응답 페이로드에 포함되지 않습니다.
목록-구성
GET /v1/projects/{project_id}/configs
- 이 조작은 이제 페이지 번호가 매겨집니다.
limit조회 매개변수에 페이지 크기가 지정되지 않은 경우 기본값인 10개의 레코드가 리턴됩니다.- 최대 페이지 크기는 100개의 레코드입니다.
- 첫 번째 페이지는 요청 URL에서 토큰 조회 매개변수 없이 리턴됩니다. 예를 들어,
GET /v1/projects/{project_id}/configs/?limit=5또는GET /v1/projects/{project_id}/configs입니다.- 지정된 페이지 토큰이 올바르지 않은 경우에도 첫 번째 페이지가 리턴됩니다.
목록 환경
GET /v1/projects/{project_id}/environments
- 이 조작은 이제 페이지 번호가 매겨집니다.
limit조회 매개변수에 페이지 크기가 지정되지 않은 경우 기본값인 10개의 레코드가 리턴됩니다.- 최대 페이지 크기는 100개의 레코드입니다.
- 첫 번째 페이지는 요청 URL에서
token조회 매개변수 없이 리턴됩니다. 예를 들어,GET /v1/projects/{project_id}/environments/?limit=5또는GET /v1/projects/{project_id}/environments입니다.- 지정된 페이지 토큰이 올바르지 않은 경우에도 첫 번째 페이지가 리턴됩니다.
배치 가능한 아키텍처 스택을 지원하는 메소드
시범
배치 가능한 아키텍처 스태킹 을 지원하는 실험적 방법이 추가되었습니다.
2023년 11월 6 일
최신 업데이트에는 다음과 같은 최신 변경사항이 포함되어 있습니다.
- 모든 메소드에 대한
configurationsresponse모델은 더 이상pipeline_state를 사용하지 않습니다.configuration의 모든 상태 정보는configuration의 표준 스키마에 있는 기능 보강된state특성에서 사용 가능합니다.
프로젝트 및 구성 변경사항
create-project: POST /v1/projects
resource_group및location는 이제request페이로드에 임베드됩니다. 더 이상 조회 매개변수로 지원되지 않습니다.
delete-config: PATCH /v1/projects/{project_id}/configs/{id}
draft_only조회 매개변수는 더 이상 사용되지 않습니다.- API는 이제 지정된 프로젝트 ID및
version의configuration삭제를 지원합니다. 프로젝트#delete-config - version 을 참조하십시오.
이름이 바뀐 구성 엔드포인트
다음 구성 엔드포인트의 이름은 다음과 같이 변경됩니다.
POST /v1/projects/{project_id}/configs/{id}/check가POST /v1/projects/{project_id}/configs/{id}/validate로 변경됩니다.POST /v1/projects/{project_id}/configs/{id}/install가POST /v1/projects/{project_id}/configs/{id}/deploy로 변경됩니다.POST /v1/projects/{project_id}/configs/{id}/uninstall가POST /v1/projects/{project_id}/configs/{id}/undeploy로 변경됩니다.
대체된 구성 엔드포인트
drafts 메소드는 다음과 같이 versions 조작으로 대체되었습니다.
GET /v1/projects/{project_id}/configs/{config_id}/drafts가GET /v1/projects/{project_id}/configs/{id}/versions로 변경됩니다.GET /v1/projects/{project_id}/configs/{config_id}/drafts/{version}은GET /v1/projects/{project_id}/configs/{id}/versions/{version}로 변경됩니다.
구성 상태
configurations 의 상태 모델이 평탄화되었습니다. pipeline_state 는 더 이상 사용할 수 없으며 하나의 state 특성이 이제 configuration 의 모든 가능한 상태를 캡처하도록 기능 보강됩니다.
다음은 새 state 값입니다.
approveddeleteddeletingdeleting_faileddiscardeddeployeddeploying_faileddeployingsupercededundeployingundeploying_failedvalidatedvalidatingvalidating_failed
모든 configuration 엔드포인트는 response 모델에 이 state 특성을 포함합니다. 예를 들어, projects#get-config-version-response 를 참조하십시오.
새 메타데이터 구성
configurations 조작의 response 모델은 이제 루트에서 새 메타데이터를 정의합니다. approve 작업이 configuration 에서 실행된 경우 approved_version 특성이 response 페이로드에 포함됩니다. 마찬가지로 deploy 작업이 configuration 에서 실행된 경우 deployed_version 및 last_deployed 메타데이터를 response 본문에서 사용할 수 있습니다. validation 작업을 실행하면 last_validated 메타데이터가 생성되는 반면, undeploy 작업을 실행하면 response 에서 last_undeployed 메타데이터가 생성됩니다.
2023년 10월 25 일
projects 및 configurations 조작 (예: create 및 update) 에서 name 및 description 와 같은 정의 특성은 이제 definition 랩퍼에서 제공되어야 합니다. 마찬가지로, 이러한 특성은 이제 create,
update, get 및 list 조작의 response 페이로드에서 definition 블록 내에서만 사용 가능합니다. 이는 원래 2023년 7월 6일에 출시된 획기적인 변화다. 다음 절에서는 이 업데이트의 영향을 받는 메소드에 대한 자세한 정보를 제공합니다.
프로젝트
create-project: POST /v1/projects
request&response의 경우name,description및destroy_on_delete가 이제definition오브젝트 내에 랩핑됩니다.- 이 엔드포인트의 호출자는 이제 이 랩퍼 내에서 정의 특성을 제공할 것으로 예상됩니다. 예를 들어, 다음과 같습니다.
definition: {“name”: “test”, “description”: “This is a test project”, “destroy_on_delete”: false}.destroy_on_delete가 제공되지 않으면 프로젝트 작성 조작에서 기본값true가 지정됩니다.
- projects#create-project - request 를 참조하십시오.
- 마찬가지로
response본문에서 이전에 언급된 특성을 이제definition블록에서 사용할 수 있습니다.- 프로젝트#create-project - response 를 참조하십시오.
update-project: PATCH /v1/projects/{id}
request&response의 경우name,description및destroy_on_delete가 이제definition오브젝트 내에 랩핑됩니다.- 이 엔드포인트의 호출자는 이제 이 랩퍼 내에서 정의 특성을 제공할 것으로 예상됩니다. 예를 들어, 다음과 같습니다.
definition: {“name”: “test_update”, “description”: “This is an updated test project“}.- projects#update-project - request 를 참조하십시오.
- 마찬가지로
response본문에서 이전에 언급된 특성을 이제definition블록에서 사용할 수 있습니다.- 프로젝트#update-project - response 를 참조하십시오.
get-projects: GET /v1/projects/{id}
- 이 조작의
response에서name,description및destroy_on_delete는 이제definition블록 내에 랩핑됩니다.- 프로젝트#get-project - response 를 참조하십시오.
list-project: GET /v1/projects
response배열에서 리턴되는 각 프로젝트는definition블록에서name,description및destroy_on_delete특성을 랩핑합니다.- 프로젝트#list-projects - response 를 참조하십시오.
구성
create-config: POST /v1/projects/{project_id}/configs
request&response의 경우,locator_id,name,labels,authorizations,compliance_profile,input,setting,description가 이제definition오브젝트 내에 랩핑됩니다.- 이 엔드포인트의 호출자는 이제 이 랩퍼 내에서 정의 특성을 제공할 것으로 예상됩니다. 예를 들어, 다음과 같습니다.
definition: {“name”: “test”, “description”: “This is a test config”, “locator_id”: “1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.cd596f95-95a2-4f21-9b84-477f21fd1e95-global”}.- 프로젝트#create-config - request 를 참조하십시오.
- 마찬가지로
response본문에서 이전에 언급된 특성을 이제definition블록에서 사용할 수 있습니다.setting특성도definition블록에 포함되어 있습니다.- 프로젝트#create-config - response 를 참조하십시오.
update-config: PATCH /v1/projects/{project_id}/configs/{id}
request&response의 경우,locator_id,name,labels,authorizations,compliance_profile,input,setting,description가 이제definition오브젝트 내에 랩핑됩니다.- 이 엔드포인트의 호출자는 이제 이 랩퍼 내에서 정의 특성을 제공할 것으로 예상됩니다. 예를 들어, 다음과 같습니다.
definition: {“name”: “test”, “description”: “This is a test config”, “locator_id”: “1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.cd596f95-95a2-4f21-9b84-477f21fd1e95-global”}.- 프로젝트#update-config - request 를 참조하십시오.
- 마찬가지로
response본문에서 이전에 언급된 특성은definition블록으로 이동됩니다.- 프로젝트#update-config - response 를 참조하십시오.
get-config: GET /v1/projects/{id}
- 이 조작의
response에서locator_id,name,labels,authorizations,compliance_profile,input,setting,description및setting는 이제definition오브젝트 내에 랩핑됩니다.- 프로젝트#get-config - response 를 참조하십시오.
list-configs: GET /v1/projects/{project_id}/configs
- 이 조작의
response에서name및description는 이제definition오브젝트 내에 랩핑됩니다.- 프로젝트#list-configs - response 를 참조하십시오.
2023년 7월 6 일
모든 메소드에 대한 응답 모델은 이제 state 값에 소문자 형식을 적용합니다. 이 형식은 프로젝트 및 구성 엔드포인트를 호출할 때 응답에서 예상됩니다. 이 업데이트는 중단된 변경입니다.
프로젝트 state 값은 이제 ready, deleting 및 deleting_failed 일 수 있습니다. 예를 들어, update-project 메소드에 대한 응답 스키마 를 참조하십시오.
구성 state 값은 이제 deleted, deleting, deleting_failed, installed, installed_failed, installing, not_installed, uninstalling, uninstalling_failed 및 active 가 될 수 있습니다. 예를 들어, get-config 메소드에 대한 응답 스키마 를 참조하십시오.