Il supporto di Cloud Deployment Manager terminerà il 31 dicembre 2025. Se al momento utilizzi Deployment Manager, esegui la migrazione a Infrastructure Manager o a una tecnologia di deployment alternativa entro il 31 dicembre 2025 per assicurarti che i tuoi servizi continuino senza interruzioni.
Chiamare un provider di tipi in una configurazione
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive come utilizzare un provider di tipi creato con
Deployment Manager. Non descrive come creare un
provider di tipi. Per scoprire come creare un fornitore di tipi, leggi
Creazione di un fornitore di tipi.
Se vuoi utilizzare gli esempi di API in questa guida, configura l'accesso API.
Accesso ai provider di tipi
I provider di tipi sono una risorsa per progetto e sono accessibili in base alle autorizzazioni descritte nella documentazione Controllo accesso. Ossia:
Gli editor e i visualizzatori del progetto possono creare e utilizzare i tipi disponibili per quel progetto.
Gli spettatori dei tipi possono ottenere un elenco dei tipi disponibili per il progetto e utilizzarli.
Puoi anche aggiungere un altro progetto come visualizzatore di tipi in modo che possa accedere ai tuoi tipi.
Leggi Condivisione dei tipi tra progetti.
Utilizzo di un provider di tipi
Per utilizzare un tipo esposto da un provider di tipi nella configurazione, utilizza
la seguente sintassi:
type:[PROJECT_ID]/[TYPE_NAME]:[COLLECTION]
Se questa API è supportata da una specifica OpenAPI, [COLLECTION] sarebbe
l'identificatore REST per il percorso della risorsa. Ad esempio:
Se l'API è supportata da un documento di rilevamento di Google, [COLLECTION] è
il percorso delle risorse che porta alla risorsa desiderata nell'API. Ad esempio, per creare una chiave del service account, la raccolta sarebbe:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-03 UTC."],[[["\u003cp\u003eThis page explains how to use a type provider created with Deployment Manager, but does not cover the creation of a type provider itself.\u003c/p\u003e\n"],["\u003cp\u003eType providers are a per-project resource, and project editors and viewers can create and use types, while type viewers can only get a list of and use types.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize a type exposed by a type provider in your configuration, use the specified syntax: \u003ccode\u003etype: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]\u003c/code\u003e, where \u003ccode\u003e[COLLECTION]\u003c/code\u003e is the REST identifier or resource path in the API.\u003c/p\u003e\n"],["\u003cp\u003ePre-GA products and features, like the type provider, are available "as is" under the "Pre-GA Offerings Terms" and might have limited support.\u003c/p\u003e\n"],["\u003cp\u003eTo add another project as a type viewer so they can access your types, you can read about \u003ca href=\"/deployment-manager/docs/configuration/sharing-types-across-projects\"\u003eSharing Types Across Projects\u003c/a\u003e.\u003c/p\u003e\n"]]],[],null,["# Calling a Type Provider in a Configuration\n\n| **Beta**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis page describes how to use a type provider that you have created with\nDeployment Manager. It does not describe how to create a\ntype provider. To learn how to create a type provider, read\n[Creating a Type Provider](/deployment-manager/docs/configuration/type-providers/creating-type-provider).\n\nBefore you begin\n----------------\n\n- If you want to use the command-line examples in this guide, install the [\\`gcloud\\` command-line tool](/sdk).\n- If you want to use the API examples in this guide, set up [API access](/deployment-manager/docs/reference/latest).\n\nAccessing type providers\n------------------------\n\nTypes providers are a per-project resource and are accessible according to the\npermissions described on the\n[Access Control](/deployment-manager/docs/access-control) documentation. That is:\n\n- **Project editors and viewers** can create and use types available to that project.\n- **Type viewers** can get a list of and use types available to that project.\n\nYou can also add another project as a type viewer so they can access your types.\nRead [Sharing Types Across Projects](/deployment-manager/docs/configuration/sharing-types-across-projects).\n\nUsing a type provider\n---------------------\n\nTo use a type exposed by a type provider in your configuration, use\nthe following syntax: \n\n type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]\n\n- If this API is backed by an OpenAPI specification, `[COLLECTION]` would be\n the REST identifier for the path to the resource. For example:\n\n type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people\n\n- If the API is backed by a Google Discovery document, `[COLLECTION]` is\n the path of resources leading to your desired resource in the API. For\n example, to create a\n [service account key](/iam/reference/rest/v1/projects.serviceAccounts.keys), the collection would be:\n\n type: my-project/example-type-provider:projects.serviceAccounts.keys\n\nNow you continue configuring your type as required by the underlying API: \n\n resources:\n - name: Jane\n type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people\n properties:\n - displayName: Jane\n email: jane@example.com\n ...\n\nWhat's next\n-----------\n\n- Read about [creating a configuration](/deployment-manager/docs/configuration).\n- [Create a deployment](/deployment-manager/docs/deployments).\n- Learn how to [create a type provider](/deployment-manager/docs/configuration/type-providers/creating-type-provider)\n- Learn more about [Advanced API Options](/deployment-manager/docs/configuration/type-providers/advanced-configuration-options)."]]
