Obligatorio. La colección superior en la que se debe crear el DeliveryPipeline. El formato debe ser projects/{projectId}/locations/{location_name}.
Parámetros de consulta
Parámetros
deliveryPipelineId
string
Obligatorio. Es el ID de DeliveryPipeline.
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 DeliveryPipeline.
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 \u003ccode\u003eDeliveryPipeline\u003c/code\u003e within a specified project and location.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a \u003ccode\u003ePOST\u003c/code\u003e method with a URL structure that incorporates gRPC Transcoding syntax and requires \u003ccode\u003eparent\u003c/code\u003e as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eQuery parameters allow the specification of \u003ccode\u003edeliveryPipelineId\u003c/code\u003e, \u003ccode\u003erequestId\u003c/code\u003e, and \u003ccode\u003evalidateOnly\u003c/code\u003e options, which can control aspects of the request, such as ensuring uniqueness or validation prior to actual change.\u003c/p\u003e\n"],["\u003cp\u003eThe request body expects an instance of \u003ccode\u003eDeliveryPipeline\u003c/code\u003e, while a successful response contains an instance of \u003ccode\u003eOperation\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003eclouddeploy.deliveryPipelines.create\u003c/code\u003e IAM permission on the \u003ccode\u003eparent\u003c/code\u003e resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.deliveryPipelines.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 DeliveryPipeline in a given project and location.\n\n### HTTP request\n\n`POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*}/deliveryPipelines`\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 [DeliveryPipeline](/deploy/docs/api/reference/rest/v1/projects.locations.deliveryPipelines#DeliveryPipeline).\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.deliveryPipelines.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
