Obligatorio. La colección superior en la que se debe crear el Target. El formato debe ser projects/{projectId}/locations/{location_name}.
Parámetros de consulta
Parámetros
targetId
string
Obligatorio. Es el ID de Target.
requestId
string
Opcional. Un ID de solicitud para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar la solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor garantiza eso durante al menos 60 minutos después de la primera solicitud.
Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera de la solicitud. Si vuelves a hacer la solicitud con el mismo ID de solicitud, el servidor puede verificar si se recibió la operación original con el mismo ID de solicitud y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente.
El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000).
validateOnly
boolean
Opcional. Si se configura como verdadera, se valida la solicitud y se le proporciona al usuario un resultado esperado, pero no se realiza ningún cambio real.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Target.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-06-25 (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)."]]
