Obligatoire. Collection parente dans laquelle créer le Target. Le format doit être le suivant : projects/{projectId}/locations/{location_name}.
Paramètres de requête
Paramètres
targetId
string
Obligatoire. ID de Target.
requestId
string
Facultatif. ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique afin que, si vous devez relancer la requête, le serveur sache qu'il doit l'ignorer si elle est déjà terminée. Le serveur garantit que pendant au moins 60 minutes après la première requête.
Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.
L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.
validateOnly
boolean
Facultatif. Si la valeur est "true", la requête est validée et l'utilisateur reçoit un résultat attendu, mais aucune modification réelle n'est apportée.
Corps de la requête
Le corps de la requête contient une instance de Target.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/05/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/05/29 (UTC)."],[[["\u003cp\u003eThis API endpoint allows you to create a new Target within a specified project and location.\u003c/p\u003e\n"],["\u003cp\u003eThe request uses a \u003ccode\u003ePOST\u003c/code\u003e HTTP method with a specific URL structure, including required \u003ccode\u003eparent\u003c/code\u003e path parameters for the project and location.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003etargetId\u003c/code\u003e query parameter, and allows optional \u003ccode\u003erequestId\u003c/code\u003e and \u003ccode\u003evalidateOnly\u003c/code\u003e query parameters for additional control.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of a \u003ccode\u003eTarget\u003c/code\u003e, while the successful response will include an instance of \u003ccode\u003eOperation\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization to use this endpoint requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003eclouddeploy.targets.create\u003c/code\u003e IAM permission on the \u003ccode\u003eparent\u003c/code\u003e resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.targets.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nCreates a new Target in a given project and location.\n\n### HTTP request\n\n`POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*}/targets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Target](/deploy/docs/api/reference/rest/v1/projects.locations.targets#Target).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/deploy/docs/api/reference/rest/v1/projects.locations.operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `clouddeploy.targets.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]