Creates a new subscription.
HTTP request
POST https://{endpoint}/v1/admin/{parent=projects/*/locations/*}/subscriptions
Where {endpoint}
is one of the supported service endpoints.
The URLs use gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
Required. The parent location in which to create the subscription. Structured like Authorization requires the following IAM permission on the specified resource
|
Query parameters
Parameters | |
---|---|
subscriptionId |
Required. The ID to use for the subscription, which will become the final component of the subscription's name. This value is structured like: |
skipBacklog |
If true, the newly created subscription will only receive messages published after the subscription was created. Otherwise, the entire message backlog will be received on the subscription. Defaults to false. |
Request body
The request body contains an instance of Subscription
.
Response body
If successful, the response body contains a newly created instance of Subscription
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.