이 페이지에서는 Deployment Manager로 만든 유형 공급자를 사용하는 방법을 설명합니다. 유형 공급자를 만드는 방법은 설명하지 않습니다. 유형 공급자를 만드는 방법을 알아 보려면 유형 공급자 만들기를 참조하세요.
시작하기 전에
- 이 가이드의 명령줄 예시를 사용하려면 'gcloud' 명령줄 도구를 설치합니다.
- 이 가이드의 API 예시를 사용하려면 API 액세스를 설정합니다.
유형 공급자 액세스
유형 공급자는 프로젝트별 리소스이고 액세스 제어 문서에 설명된 권한에 따라 액세스할 수 있습니다. 즉, 다음과 같습니다.
- 프로젝트 편집자 및 뷰어는 해당 프로젝트에 제공되는 유형을 만들고 사용할 수 있습니다.
- 유형 뷰어는 해당 프로젝트에 제공되는 유형 목록을 가져오고 사용할 수 있습니다.
또한 자신의 유형에 액세스할 수 있도록 다른 프로젝트를 유형 뷰어로 추가할 수 있습니다. 프로젝트 간 유형 공유를 참조하세요.
유형 공급자 사용
구성에서 유형 공급자로 노출된 유형을 사용하려면 다음 구문을 사용합니다.
type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]
이 API가 OpenAPI 사양으로 지원되는 경우,
[COLLECTION]
은 해당 리소스에 대한 경로의 REST 식별자입니다. 예를 들면 다음과 같습니다.type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
Google Discovery 문서에서 지원하는 API인 경우
[COLLECTION]
은 API에서 원하는 리소스로 연결되는 리소스 경로입니다. 예를 들어 서비스 계정 키를 만들려는 경우 컬렉션은 다음과 같습니다.type: my-project/example-type-provider:projects.serviceAccounts.keys
이제 기본 API에 필요한 대로 유형을 계속 구성할 수 있습니다.
resources:
- name: Jane
type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
properties:
- displayName: Jane
email: jane@example.com
...
다음 단계
- 구성 만들기에 대해 알아봅니다.
- 배포를 만듭니다.
- 유형 공급자를 만드는 방법을 알아봅니다.
- 고급 API 옵션에 대해 알아봅니다.